Edgewall Software

Changes between Version 128 and Version 129 of TracStandalone


Ignore:
Timestamp:
Jun 14, 2022, 5:49:30 PM (3 weeks ago)
Author:
figaro
Comment:

Cosmetic updates

Legend:

Unmodified
Added
Removed
Modified
  • TracStandalone

    v128 v129  
    44It can be used in a variety of situations, from a test or development server to a multiprocess setup behind another web server used as a load balancer.
    55
    6 == Pros
    7 
     6'''Pros'''
    87 * Fewer dependencies: You don't need to install Apache or any other web-server.
    98 * Fast: Should be almost as fast as the [wiki:TracModWSGI mod_wsgi] version (and much faster than the [wiki:TracCgi CGI]), especially since the HTTP/1.1 version of the protocol is enabled by default.
    109 * Automatic reloading: For development, Tracd can be used in ''auto_reload'' mode, which will automatically restart the server whenever you make a change to the code, for example in Trac itself or in a plugin.
    1110
    12 == Cons
    13 
     11'''Cons'''
    1412 * Fewer features: Tracd implements a very simple web-server and is not as configurable or as scalable as Apache httpd.
    1513
    1614== Usage examples
    1715
    18 A single project on port 8080. (http://localhost:8080/)
     16A single project on port 8080, such as `http://localhost:8080/`:
    1917{{{#!sh
    2018 $ tracd -p 8080 /path/to/project
    2119}}}
    22 Strictly speaking this will make your Trac accessible to everybody from your network rather than ''localhost only''. To truly limit it use the `--hostname` option.
     20Strictly speaking this will make your Trac accessible to everybody from your network rather than `localhost` only. To truly limit it use the `--hostname` option.
    2321{{{#!sh
    2422 $ tracd --hostname=localhost -p 8080 /path/to/project
    2523}}}
    26 With more than one project. (http://localhost:8080/project1/ and http://localhost:8080/project2/)
     24With more than one project, for example `http://localhost:8080/project1/` and `http://localhost:8080/project2/`:
    2725{{{#!sh
    2826 $ tracd -p 8080 /path/to/project1 /path/to/project2
     
    6361
    6462{{{#!div
    65 Once the service is installed, it might be simpler to run the Registry Editor rather than use the `reg add` command documented above.  Navigate to:[[BR]]
     63Once the service is installed, it might be simpler to run the Registry Editor rather than use the `reg add` command documented above. Navigate to:[[BR]]
    6664`HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\tracd\Parameters`
    6765
     
    9896
    9997{{{#!div style="border: 1pt dotted; margin: 1em"
    100 **Attention:** Make sure you place the generated password files on a filesystem which supports sub-second timestamps, as Trac will monitor their modified time and changes happening on a filesystem with too coarse-grained timestamp resolution (like `ext2` or `ext3` on Linux, or HFS+ on OSX).
     98**Attention:** Make sure you place the generated password files on a filesystem which supports sub-second timestamps, as Trac will monitor their modified time and changes happening on a filesystem with too coarse-grained timestamp resolution, like `ext2` or `ext3` on Linux, or HFS+ on OSX.
    10199}}}
    102100
     
    116114 * '''project_path''': path of the project
    117115
    118  * **`--auth`** in the above means use Digest authentication, replace `--auth` with `--basic-auth` if you want to use Basic auth.  Although Basic authentication does not require a "realm", the command parser does, so the second comma is required, followed directly by the closing quote for an empty realm name.
     116 * **`--auth`** in the above means use Digest authentication, replace `--auth` with `--basic-auth` if you want to use Basic auth. Although Basic authentication does not require a "realm", the command parser does, so the second comma is required, followed directly by the closing quote for an empty realm name.
    119117
    120118Examples:
     
    144142This section describes how to use `tracd` with Apache .htpasswd files.
    145143
    146 '''Note''': On Windows It is necessary to install the [https://pypi.python.org/pypi/passlib passlib] package in order to decode some htpasswd formats. Only `SHA-1` passwords (since Trac 1.0) work without this module.
     144'''Note''': On Windows It is necessary to install the [https://pypi.python.org/pypi/passlib passlib] package in order to decode some htpasswd formats. Only `SHA-1` passwords work without this module (since Trac 1.0).
    147145
    148146To create a .htpasswd file use Apache's `htpasswd` command (see [#GeneratingPasswordsWithoutApache below] for a method to create these files without using Apache):
     
    169167=== Digest authentication: Using a htdigest password file
    170168
    171 If you have Apache available, you can use the htdigest command to generate the password file. Type 'htdigest' to get some usage instructions, or read [https://httpd.apache.org/docs/2.0/programs/htdigest.html this page] from the Apache manual to get precise instructions.  You'll be prompted for a password to enter for each user that you create. For the name of the password file, you can use whatever you like, but if you use something like `users.htdigest` it will remind you what the file contains. As a suggestion, put it in your <projectname>/conf folder along with the [TracIni trac.ini] file.
     169If you have Apache available, you can use the htdigest command to generate the password file. Type 'htdigest' to get some usage instructions, or read [https://httpd.apache.org/docs/2.0/programs/htdigest.html this page] from the Apache manual to get precise instructions. You will be prompted for a password to enter for each user that you create. For the name of the password file, you can use whatever you like, but if you use something like `users.htdigest` it will remind you what the file contains. As a suggestion, put it in your <projectname>/conf folder along with the [TracIni trac.ini] file.
    172170
    173171Note that you can start tracd without the `--auth` argument, but if you click on the ''Login'' link you will get an error.
     
    175173=== Generating Passwords Without Apache
    176174
    177 Basic Authorization can be accomplished via this [http://aspirine.org/htpasswd_en.html online HTTP Password generator] which also supports `SHA-1`.  Copy the generated password-hash line to the .htpasswd file on your system. Note that Windows Python lacks the "crypt" module that is the default hash type for htpasswd. Windows Python can grok MD5 password hashes just fine and you should use MD5.
     175Basic Authorization can be accomplished via this [http://aspirine.org/htpasswd_en.html online HTTP Password generator] which also supports `SHA-1`. Copy the generated password-hash line to the .htpasswd file on your system. Note that Windows Python lacks the "crypt" module that is the default hash type for htpasswd. Windows Python can grok MD5 password hashes just fine and you should use MD5.
    178176
    179177Trac also provides `htpasswd` and `htdigest` scripts in `contrib`:
     
    340338=== Serving a different base path than /
    341339
    342 Tracd supports serving projects with different base urls than /<project>. The parameter name to change this is:
     340Tracd supports serving projects with different base urls than `/<project>` with the `base_path` parameter:
    343341{{{#!sh
    344342 $ tracd --base-path=/some/path