123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227 |
- <!DOCTYPE html>
- <html lang="en">
- <head>
- <title>Running GoAhead</title>
-
- <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
- <meta charset="utf-8">
- <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
- <meta name="viewport" content="width=device-width,initial-scale=1,maximum-scale=1">
- <meta name="description" content="GoAhead web server">
- <link href='https://fonts.googleapis.com/css?family=Source+Sans+Pro:400,700|Open+Sans:300italic,400,300,700' rel='stylesheet' type='text/css'>
- <link href='https://fonts.googleapis.com/css?family=Julius+Sans+One' rel='stylesheet' type='text/css'>
-
- <link href="../images/favicon.ico" rel="shortcut icon">
- <link href="../lib/semantic-ui/semantic.min.css" rel="stylesheet" type="text/css">
- <link href="../css/all.min.css" rel="stylesheet" type="text/css">
- <link href="../css/api.min.css" rel="stylesheet" type="text/css">
-
- </head>
- <body class="show-sidebar">
- <div class="sidebar">
- <div class="ui large left vertical inverted labeled menu">
- <div class="item">
- <a href="../" class="logo">GoAhead Docs</a>
- </div>
- <div class="item">
- <a href="../">
- <b>General</b>
- </a>
- <div class="menu">
- <a class="item" href="../">GoAhead Overview</a>
- <a class="item" href="../users/features.html">GoAhead Features</a>
- <a class="item" href="https://embedthis.com/goahead/download.html">Download</a>
- <a class="item" href="../licensing/">Licensing</a>
- </div>
- </div>
- <div class="item">
- <a href="../start/">
- <b>Getting Started</b>
- </a>
- <div class="menu">
- <a class="item" href="../start/quick.html">Quick Start</a>
- <a class="item" href="../start/installing.html">Installing GoAhead</a>
- <a class="item" href="../start/running.html">Running GoAhead</a>
- <a class="item" href="../start/releaseNotes.html">Release Notes</a>
- <a class="item" href="../start/faq.html">GoAhead FAQ</a>
- <a class="item" href="../start/source.html">Building from Source</a>
- </div>
- </div>
- <div class="item">
- <a href="../users/"><b>User's Guide</b></a>
- <div class="menu">
- <a class="item" href="../users/ports.html">Ports and Binding</a>
- <a class="item" href="../users/routing.html">Routing Requests</a>
- <a class="item" href="../users/handlers.html">Request Handlers</a>
- <a class="item" href="../users/js.html">Embedded Javascript</a>
- <a class="item" href="../users/jst.html">Javascript Templates</a>
- <a class="item" href="../users/goactions.html">GoActions</a>
- <a class="item" href="../users/cgi.html">CGI Programs</a>
- <a class="item" href="../users/authentication.html">User Authentication</a>
- <a class="item" href="../users/logFiles.html">Log Files</a>
- <a class="item" href="../users/ssl.html">Secure Sockets (SSL)</a>
- <a class="item" href="../users/security.html">Security Considerations</a>
- <a class="item" href="../users/man.html">Man Pages</a>
- </div>
- </div>
- <div class="item">
- <a href="../developers/">Developer's Guide</a>
- <div class="menu">
- <a class="item" href="../developers/embedding.html">Embedding GoAhead</a>
- <a class="item" href="../developers/handlers.html">Creating GoAhead Handlers</a>
- <a class="item" href="../developers/authstore.html">Creating Password Verifiers</a>
- <a class="item" href="../developers/migrating.html">Migrating to GoAhead 3/4</a>
- <a class="item" href="../developers/rom.html">Serving Pages from ROM</a>
- </div>
- </div>
- <div class="item">
- <a href="../ref/">Reference Guide</a>
- <div class="menu">
- <a class="item" href="../ref/compatibility.html">Compatibility</a>
- <a class="item" href="../ref/native.html">API Library</a>
- <a class="item" href="../ref/architecture.html">GoAhead Architecture</a>
- <a class="item" href="../standards/http.html">HTTP References</a>
- </div>
- </div>
- <div class="item">
- <a href="../developers/project.html">Project Resources</a>
- <div class="menu">
- <a class="item" href="https://embedthis.com/blog/categories/GoAhead/">GoAhead News</a>
- <a class="item" href="https://embedthis.com/goahead/">GoAhead Web Site</a>
- <a class="item" href="https://github.com/embedthis/goahead">Source Code Repository</a>
- <a class="item" href="https://github.com/embedthis/goahead/issues/99">GoAhead Security Alerts</a>
- <a class="item" href="https://github.com/embedthis/goahead/issues">Project Issue Database</a>
- <a class="item" href="https://github.com/embedthis/goahead/releases">Change Log</a>
- <a class="item" href="https://github.com/embedthis/goahead/milestones">Roadmap</a>
- <a class="item" href="https://embedthis.com/developers/contributors.html">Contributors Agreement</a>
- </div>
- </div>
- <div class="item">
- <b>Links</b>
- <div class="menu">
- <a class="item" href="https://embedthis.com/">Embedthis Web Site</a>
- <a class="item" href="https://embedthis.com/blog/">Embedthis Blog</a>
- <a class="item" href="http://twitter.com/embedthat">Twitter</a>
- </div>
- </div>
- </div>
- </div>
- <div class="ui inverted masthead">
- <div class="ui fixed inverted menu">
- <div class="ui sidebar-launch button">
- <i class="icon list layout"></i>
- </div>
- <div class="right menu">
- <a class="item" href="https://embedthis.com/">Embedthis</a>
- <a class="item" href="https://embedthis.com/goahead/">GoAhead Site</a>
- <span class="desktop-only">
- <a class="item" href="https://embedthis.com/blog/categories/GoAhead/">GoAhead News</a>
- <a class="item" href="https://github.com/embedthis/goahead">Repository</a>
- <a class="item" href="https://embedthis.com/blog/">Blog</a>
- <a class="item" href="https://twitter.com/embedthat">Twitter</a>
- </span>
- </div>
- </div>
-
- <div class="ui breadcrumb">
- <a class="section" href="../">Home</a>
-
- <div class="divider">/</div>
- <a class="section" href="../start/">
- Getting Started
- </a>
-
-
- <div class="divider">/</div>
- <a class="active section" href="running.html">Running GoAhead</a>
-
- </div>
-
- <iframe class="version desktop-only" src="../version.html"></iframe>
- </div>
- <div class="content">
- <h1>Running GoAhead</h1>
- <p>GoAhead is built to listen on default ports specified at build time. These are typically set to port 80 for
- HTTP and port 443 for SSL. However, you can override these via GoAhead command line options. If <em>goahead</em> is invoked
- with an IP address or port number on the command line, GoAhead will listen on that IP address and not the
- default.</p>
- <p>The GoAhead command line usage is:</p>
- <pre class="ui code segment">
- goahead [options] [documents] [IP]:[PORT]
- </pre>
- <p>If the PORT component is omitted, GoAhead will listen on port 80. If the IP address is omitted and a port is
- supplied, GoAhead will listen on all network interfaces. An optional document root directory can be supplied for
- the location of the web pages.</p>
- <a id="goaheadOptions"></a>
- <h2>GoAhead Command Options</h2>
- <table title="options" class="ui table segment">
- <thead>
- <tr>
- <th class="three wide">Option</th>
- <th>Description</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td>--auth filename</td>
- <td>Define the name of the authentication configuration file. This is by default auth.txt. If
- GoAhead is built with PAM support (Unix Pluggable Authentication Modules), then passwords will
- be authenticated from the system password database.</td>
- </tr>
- <tr>
- <td class="nowrap">--debugger</td>
- <td>Disable timeouts to make it easier to debug.</td>
- </tr>
- <tr>
- <td class="nowrap">--log logSpec</td>
- <td>Specify a file to log messages. This will override the ErrorLog directive in the
- configuration file. The logSpec syntax is logName[:logLevel]. When the maximum size
- is exceeded, the log file will be rotated to logName.old and a new log file will be started.
- The log level is a number between 0 and 9 where 0 is the least verbose. The -l option is an
- alias for --log.</td>
- </tr>
- <tr>
- <td class="nowrap">--home directory</td>
- <td>Specify the starting directory for the root of the server. This directory contains GoAhead
- configuration file.</td>
- </tr>
- <tr>
- <td class="nowrap">--route routeFile</td>
- <td>This option overrides the default route configuration file name of "route.txt". When
- GoAhead starts, it reads the route configuration file to load URI routes. These routes define
- what actions should be taken when various client requests are received.</td>
- </tr>
- <tr>
- <td>--verbose</td>
- <td>Shorthand for --log stderr:2. The -v option is an alias for --verbose.</td>
- </tr>
- <tr>
- <td>--version</td>
- <td>Display the goahead version number</td>
- </tr>
- </tbody>
- </table>
- </div>
- <div class="terms ui basic center aligned segment">
- <p>© Embedthis Software. All rights reserved.</p>
- </div>
- <script src="../lib/jquery/jquery.min.js"></script>
- <script src="../lib/semantic-ui/semantic.min.js"></script>
- <script src="../scripts/sidebar.min.js"></script>
-
-
|