mirror of
https://github.com/weewx/weewx.git
synced 2026-04-18 16:46:56 -04:00
117 lines
4.3 KiB
HTML
117 lines
4.3 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
|
|
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
<html xmlns="http://www.w3.org/1999/xhtml">
|
|
<head>
|
|
<title>weewx: Installation on Debian systems</title>
|
|
<meta http-equiv="Content-Language" content="en-us"/>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0"/>
|
|
<link rel="stylesheet" href="css/weewx_docs.css"/>
|
|
<link rel="icon" href="images/favicon.png" type="image/png"/>
|
|
</head>
|
|
<body>
|
|
|
|
<h1 class="title">weeWX: Installation on Debian-based systems
|
|
<div class='os-icons'>
|
|
<img class='logo' src='images/logo-debian.png' alt=""/>
|
|
<img class='logo' src='images/logo-ubuntu.png' alt=""/>
|
|
<img class='logo' src='images/logo-mint.png' alt=""/>
|
|
<img class='logo' src='images/logo-rpi.png' alt=""/>
|
|
</div>
|
|
<div style="clear: both"></div>
|
|
</h1>
|
|
|
|
<p>This is a guide to installing weeWX from a DEB package on Debian-based systems, including Ubuntu, Mint, and Raspbian.
|
|
</p>
|
|
|
|
<h2>Configure apt</h2>
|
|
<p>Tell <span class="code">apt</span> where to find the weeWX releases. This only has to be done once - the first time you install weeWX.</p>
|
|
|
|
<pre class='tty cmd'>wget -qO - http://weewx.com/keys.html | sudo apt-key add -
|
|
wget -qO - http://weewx.com/apt/weewx.list | sudo tee /etc/apt/sources.list.d/weewx.list</pre>
|
|
|
|
<h2>Install</h2>
|
|
<p>Use <span class="code">apt-get</span> to install weeWX. The installer will prompt for a location, latitude/longitude, altitude, station type, and parameters specific to your station hardware.
|
|
</p>
|
|
|
|
<pre class='tty cmd'>sudo apt-get update
|
|
sudo apt-get install weewx</pre>
|
|
|
|
<p>When you are done, weeWX will be running in the background as a daemon.
|
|
</p>
|
|
|
|
<h2>Status</h2>
|
|
<p>To make sure things are running properly look in the system log for messages from weeWX.
|
|
</p>
|
|
<pre class='tty cmd'>sudo tail -f /var/log/syslog</pre>
|
|
|
|
<h2>Verify</h2>
|
|
<p>After about 5 minutes, open the station web page in a web browser. You should see your station information and data.
|
|
</p>
|
|
<pre class='tty'><a href="file:///var/www/html/weewx/index.html">file:///var/www/html/weewx/index.html</a></pre>
|
|
<p>If your hardware supports hardware archiving, then how long you wait will depend on the <a href="usersguide.htm#archive_interval">archive interval</a> set in your hardware.
|
|
</p>
|
|
|
|
<h2>Customize</h2>
|
|
<p>To enable uploads such as Weather Underground or to customize reports, modify the configuration file <span class='code'>/etc/weewx/weewx.conf</span>. See the <a href="usersguide.htm">User Guide</a> and <a href="customizing.htm">Customization Guide</a> for details.
|
|
</p>
|
|
|
|
<p>WeeWX must be restarted for configuration file changes to take effect.
|
|
</p>
|
|
|
|
<h2>Start/Stop</h2>
|
|
<p>To start/stop weeWX:</p>
|
|
<pre class='tty cmd'>sudo /etc/init.d/weewx start
|
|
sudo /etc/init.d/weewx stop</pre>
|
|
|
|
<h2>Uninstall</h2>
|
|
<p>To uninstall weeWX but retain configuration files and data:
|
|
</p>
|
|
<pre class='tty cmd'>sudo apt-get remove weewx</pre>
|
|
<p>To uninstall weeWX, removing configuration files but retaining data:
|
|
</p>
|
|
<pre class='tty cmd'>sudo apt-get purge weewx</pre>
|
|
<p>To remove data:</p>
|
|
<pre class='tty cmd'>sudo rm -r /var/lib/weewx
|
|
sudo rm -r /var/www/html/weewx</pre>
|
|
|
|
<h2>Layout</h2>
|
|
<p>The installation will result in the following layout:</p>
|
|
<table class='locations' style='width: 50%'>
|
|
<tr>
|
|
<td align='right'>executable:</td>
|
|
<td class='tty'>/usr/bin/weewxd</td>
|
|
</tr>
|
|
<tr>
|
|
<td align='right'>configuration file:</td>
|
|
<td class='tty'>/etc/weewx/weewx.conf</td>
|
|
</tr>
|
|
<tr>
|
|
<td align='right'>skins and templates:</td>
|
|
<td class='tty'>/etc/weewx/skins</td>
|
|
</tr>
|
|
<tr>
|
|
<td align='right'>sqlite databases:</td>
|
|
<td class='tty'>/var/lib/weewx/</td>
|
|
</tr>
|
|
<tr>
|
|
<td align='right'>generated web pages and images:</td>
|
|
<td class='tty'>/var/www/html/weewx/</td>
|
|
</tr>
|
|
<tr>
|
|
<td align='right'>documentation:</td>
|
|
<td class='tty'>/usr/share/doc/weewx/</td>
|
|
</tr>
|
|
<tr>
|
|
<td align='right'>utilities:</td>
|
|
<td class='tty'>/usr/bin/wee_*</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p class='copyright'>
|
|
© <a href='copyright.htm'>Copyright</a> Tom Keffer
|
|
</p>
|
|
|
|
</body>
|
|
</html>
|