Fossil SCM
| f146e21… | drh | 1 | # Serving via althttpd |
| f146e21… | drh | 2 | |
| 44f1df9… | drh | 3 | [Althttpd][althttpd] |
| 44f1df9… | drh | 4 | is a light-weight web server that has been used to implement the SQLite and |
| 44f1df9… | drh | 5 | Fossil websites for well over a decade. Althttpd strives for simplicity, |
| 44f1df9… | drh | 6 | security, ease of configuration, and low resource usage. |
| 44f1df9… | drh | 7 | |
| 44f1df9… | drh | 8 | To set up a Fossil server as CGI on a host running the althttpd web |
| 44f1df9… | drh | 9 | server, follow these steps. |
| 44f1df9… | drh | 10 | <ol> |
| 1fd407f… | wyoung | 11 | <li>Get the althttpd webserver running on the host. This is easily |
| 44f1df9… | drh | 12 | done by following the [althttpd documentation][althttpd]. |
| 44f1df9… | drh | 13 | |
| 1fd407f… | wyoung | 14 | <li>Create a CGI script for your Fossil repository. The script will |
| 44f1df9… | drh | 15 | be typically be two lines of code that look something like this: |
| 44f1df9… | drh | 16 | |
| 44f1df9… | drh | 17 | ~~~ |
| 44f1df9… | drh | 18 | #!/usr/bin/fossil |
| 44f1df9… | drh | 19 | repository: /home/yourlogin/fossils/project.fossil |
| 44f1df9… | drh | 20 | ~~~ |
| 44f1df9… | drh | 21 | |
| 44f1df9… | drh | 22 | Modify the filenames to conform to your system, of course. The |
| 44f1df9… | drh | 23 | CGI script accepts [other options][cgi] besides the |
| 44f1df9… | drh | 24 | repository:" line. You can add in other options as you desire, |
| 44f1df9… | drh | 25 | but the single "repository:" line is normally all that is needed |
| 44f1df9… | drh | 26 | to get started. |
| 44f1df9… | drh | 27 | |
| 1fd407f… | wyoung | 28 | <li>Make the CGI script executable. |
| 44f1df9… | drh | 29 | |
| 1fd407f… | wyoung | 30 | <li>Verify that the fossil repository file and the directory that contains |
| 44f1df9… | drh | 31 | the repository are both writable by whatever user the web server is |
| 44f1df9… | drh | 32 | running and. |
| 44f1df9… | drh | 33 | </ol> |
| 44f1df9… | drh | 34 | |
| 44f1df9… | drh | 35 | And you are done. Visit the URL that corresponds to the CGI script |
| 44f1df9… | drh | 36 | you created to start using your Fossil server. |
| f146e21… | drh | 37 | |
| f146e21… | drh | 38 | *[Return to the top-level Fossil server article.](../)* |
| f146e21… | drh | 39 | |
| f146e21… | drh | 40 | |
| 6ef97bd… | drh | 41 | [althttpd]: https://sqlite.org/althttpd/ |
| 44f1df9… | drh | 42 | [cgi]: ../../cgi.wiki |