path: root/doc/setup.md
blob: a70427466aab6fb7526a95f76256e4729fa24f11 (plain)

Filesharing setup

[[File_shares|intro]] is accessible in different ways. Via the Macintosh-friendly afp or the more generic sftp.

Macintosh-friendly access (afp)

The easiest method is using the "Apple Filesharing Protocol", afp. It is integrated in both MacOS X and the older MacOS Classic, and provides separate access to each personal and group share.

  1. Open filesharing:
  • With MacOS X choose "Connect to server..." from the desktop.
  • With MacOS Classic choose "AppleShare" from "Chooser" in the apple menu.
  1. Connect to the server [[!template id=filehost]]

  2. Log on using your personal access info, and choose the file shares you want bound to your machine.

Alternatively in some cases, e.g. with the MacOS X web-browser Safari, you can double-click the address <afp://[[!template id=filehost]]>

When finished using the shares, "eject" it by dropping it in the trash can.

General access (sftp)

Windows and Linux unfortunately cannot (in a simple way) use afp, and their own similar builtin methods are either too insecure (ftp, nfs) or problematic to get to work through the Internet (smb).

The alternative SSH-based sftp works on all three platforms with a helper application installed:

  1. Use an sftp application:

    • With Windows the Free Software application WinSCP is recommended.
    • With MacOS X the Free Software application Fugu is recommended.
    • With MacOS X for terminal use you can use the builtin command line tool "sftp".
    • With MacOS Classic you can use the shareware application MacSFTP
    • With Linux on X11 desktop, both Gnome and KDE have sftp support builtin.
    • With Linux on a text terminal, the application "Midnight Commander" (the command "mc") is recommended.
  2. Type in the server address [[!template id=filehost]], and your personal access info.

Alternatively your can in some cases double-click the address <sftp://[[!template id=filehost]]>

/!\ Sftp provides access to all of your personal account, without any userfriendly wrapping. Avoid moving around folders and files you do not know what is. For example the "Maildir" folder, containing all of your emails.

Sftp only provides access to your personal account. With some adjustment on the server you can also be granted access to some types of group shares as well. If you can only access personal file shares using sftp, and you need access to group shares too, then please tell your technicians to adjust your access on the server.