Installation - 1 The Fast Track
This section is for the impatient who don't want to take the time to learn their way around the command line world and don't care that they don't know what they're actually doing.
If you're looking for the real instructions, skip to the next section. (You can still use this section as an example.)
1.1 First Time Installation Fast Track
Start out by copying the fink-0.9.0-full.tar.gz
file to your home folder.
(Note: If you have OS X 10.4 and XCode 2.1, you should use
fink-0.8.0-full-XCode-2.1.tar.gz instead, and make
the appropriate changes below.)
Then, open Terminal.app and follow the session below.
Computer output is in normal face, your input is in
bold face (or otherwise highlighted).
The actual input prompts from the shell may vary, and some chunks of
the output have been omitted (...).
[frodo:~] testuser% tar xzf fink-0.9.0-full.tar.gz [frodo:~] testuser% cd fink-0.9.0-full [frodo:~/fink-0.9.0-full] testuser% ./bootstrap /sw Welcome to Fink. ... Choose a method: [1] 1 sudo /Users/testuser/fink-0.9.0-full/bootstrap .sudo '/sw' Password:(your normal password here) ... OK, I'll ask you some questions and update the configuration file in '/sw/etc/fink.conf'. In what additional directory should Fink look for downloaded tarballs? [] (press return) Always print verbose messages? [y/N] (press return) Proxy/Firewall settings Enter the URL of the HTTP proxy to use, or 'none' for no proxy. The URL should start with http:// and may contain username, password or port specifications. [none] (press return) Enter the URL of the proxy to use for FTP, or 'none' for no proxy. The URL should start with http:// and may contain username, password or port specifications. [none] (press return) Use passive mode FTP transfers (to get through a firewall)? [Y/n] y Mirror selection Choose a continent: ... (enter the numbers corresponding to your location) ... Writing updated configuration to '/sw/etc/fink.conf'... Bootstrapping a base system via /sw/bootstrap. ... (take a coffee break while Fink downloads and compiles the base packages) ... You should now have a working Fink installation in '/sw'. [frodo:~/fink-0.9.0-full] testuser% cd [frodo:~] testuser% rm -r fink-0.9.0-full [frodo:~] testuser% /sw/bin/pathsetup.sh
The last command runs a little script to help set up your Unix paths (and other things) for use with Fink. In most cases, it will run automatically, and prompt you for permission to make changes. If the script fails, you'll have to do things by hand.
(If you need to do things by hand, and you are using csh or tcsh,
you need to make sure that the command
source /sw/bin/init.csh is executed during startup of
your shell, either by .login, .cshrc, .tcshrc, or something else
appropriate. If you are using bash or similar shells, the command
you need is . /sw/bin/init.sh, and places where it
might get executed include .bashrc and .profile.)
Once you have set up the paths, open a new Terminal.app window, and close all other ones. That's it, you now have a base system installed.
You can now install additional packages with the fink
command, like this:
[frodo:~] testuser% fink install xfree86-server gimp sudo /sw/bin/fink 'install' 'xfree86-server' 'gimp' Password:(your normal password here) Reading package info... Information about 147 packages read. The following 14 additional packages will be installed: audiofile dlcompat esound giflib glib gnome-libs gtk+ imlib libjpeg libpng libtiff orbit xfree86-base zlib Do you want to continue? [Y/n] y ...
If these instructions don't work for you, well, you'll have to take the time to read through the rest of this document and the online FAQ. You can also ask on the fink-users mailing list, but expect to be pointed back at the documentation when your problem actually is well-documented.
1.2 Update Fast Track
Start out by copying the fink-0.9.0-full.tar.gz
file to your home folder.
(Note: If you have OS X 10.4 and XCode 2.1, you should use
fink-0.8.0-full-XCode-2.1.tar.gz instead, and make
the appropriate changes below.)
Then, open Terminal.app and follow the session below.
Computer output is in normal face, your input is in
bold face (or otherwise highlighted).
The actual input prompts from the shell may vary, and some chunks of
the output have been omitted (...).
[frodo:~] testuser% tar xzf fink-0.9.0-full.tar.gz [frodo:~] testuser% cd fink-0.9.0-full [frodo:~/fink-0.9.0-full] testuser% ./inject.pl /sw sudo ./inject.pl /sw Password:(your normal password here) Copying package descriptions ... Done. Your Fink installation in '/sw' was updated with new fink packages. [frodo:~/fink-0.9.0-full] testuser% cd pkginfo [frodo:~/fink-0.9.0-full/pkginfo] testuser% ./inject.pl /sw sudo ./inject.pl /sw Copying... ... Your Fink installation in '/sw' was updated with new package description files. Use appropriate fink commands to update the packages, e.g. 'fink update-all'. [frodo:~/fink-0.9.0-full/pkginfo] testuser% cd [frodo:~] testuser% rm -r fink-0.9.0-full [frodo:~] testuser% fink update-all ...