How can I get started with a web.mit.edu website?
Prerequisites
The servers at web.mit.edu and www.mit.edu use a shared file system called "AFS".
It's common to login to athena.dialup.mit.edu (over ssh) to access a machine that mounts the AFS file system.
You will need:
- Some way to access AFS
- A locker (or other AFS space) you have access to - this can be your user homedir (Request form here https://ist.mit.edu/lockers)
- Some way to edit text/html files
Option #1 - Linux/Unix tools
This path includes:
- ssh into athena.dialup.mit.edu
How can I connect to the Athena dialup servers? - navigate the file system /mit/lockername/www
AFS on Athena
How do permissions work in AFS?
Who has permission to change files in a locker or website? - use a text editor such as emacs, vi, pico to work on your website
Option #2 - sFTP client and an editor of your choice
If you are comfortable editing files in a text editor, then you can upload them to AFS using an sFTP client such as SecureFX.
How to manually configure Secure CRT and Secure FX
Technical Context
web.mit.edu runs a modified Apache, and is fronted by Akamai's caches; it does not obey directives in .htaccess, but it does obey a subset of directives in .htaccess.mit
Akamai's cache properties:
web.mit.edu page cache - Akamai
More about available .htaccess.mit directives:
Web Publishing - Redirects
Protecting a Web Directory via Certificates - more technical background
Why do I get "Forbidden" when trying to view a directory in my Athena locker over the web?
Managing the content out of github and checking it out into AFS is an option for maintaining a web.mit.edu website:
Using GitHub to Manage or Host an MIT Website
User Home page location and examples
In order to create a homepage, you need to place your HTML documents in a world readable directory named "www" in your home directory. This directory is automatically created for new accounts, so in most cases you should not need to create it. If it does not exist, and you do need to create this directory, use the commands:
cd ~ mkdir -p www fs sa www system:anyuser rl
to do so. This creates a directory named www into which you will place all files relating to your home page. Now, within that directory, you have to create a file (such as home.html) written in html format. Note that HTML documents MUST end in ".html".
Once you have created your index.html file, the URL for that page would be:
http://web.mit.edu/username/www/index.html (or http://web.mit.edu/username/www/ since index.html is assumed)
Or, you can access the index.html file through the same web server through
http://www.mit.edu/~username/index.html (or http://www.mit.edu/~username/)
See also:
Why do I get "Forbidden" when trying to view a directory in my Athena locker over the web?
Need more help?
- For more information about publishing information on the web and the capabilities of MIT's web.mit.edu and www.mit.edu servers, look at the URL:
http://ist.mit.edu/web/reference