slitaz-forge view arm/codex/setup.html @ rev 709

boot: add mypizza.slitaz.org link
author Pascal Bellard <pascal.bellard@slitaz.org>
date Sun Dec 15 17:55:16 2019 +0100 (2019-12-15)
parents d0383e006701
children
line source
1 <!DOCTYPE html>
2 <html lang="en">
3 <head>
4 <title>SliTaz ARM Codex - Setup</title>
5 <meta charset="utf-8" />
6 <meta name="viewport" content="width=device-width, initial-scale=1.0">
7 <link rel="stylesheet" type="text/css" href="style.css" />
8 <link rel="stylesheet" type="text/css" href="style-tiny.css" />
9 </head>
10 <body bgcolor="#ffffff">
12 <div id="header">
13 <div id="network"><a href="http://arm.slitaz.org/">SliTaz ARM</a></div>
14 <h1><a href=".">SliTaz ARM Codex</a></h1>
15 </div>
17 <nav id="nav" role="navigation" tabindex="0">
18 <ul>
19 <li><a class="nav1" href="faq.html">FAQ</a></li>
20 <li><a class="nav2" href="system.html">System</a></li>
21 <li><a class="nav1" href="apps.html">Apps</a></li>
22 <li><a class="nav2" href="setup.html">Setup</a></li>
23 </ul>
24 </nav>
26 <!-- Content -->
27 <div id="content">
29 <h2>Services setup guides</h2>
31 <p>
32 Setup a web server or an IRC bouncer on your nifty ARM board.
33 </p>
35 <ul>
36 <li><a href="#httpd">HTTP Web server</a></li>
37 <li><a href="#ftpd">On demand FTP server</a></li>
38 <li><a href="#znc">IRC bouncer setup</a></li>
39 <li><a href="#ntpd">Low resources NTP server</a></li>
40 </ul>
42 <h2 id="httpd">HTTP Web server</h2>
44 <p>
45 SliTaz ARM can be turned into a powerful web server, since the included
46 Busybox HTTPd daemon has some limitations, we recommend using the
47 light and fast 'lighttpd' package with modules, CGI and advanced
48 configuration support:
49 </p>
51 <pre>
52 # spk-add lighttpd
53 </pre>
55 <ul>
56 <li>Main config files: <b>/etc/lighttpd/lighttpd.conf</b></li>
57 <li>Virtual hosts configs: <b>/etc/lighttpd/vhosts.conf</b></li>
58 </ul>
60 <p>
61 You can reach your server with the IP address of the machine or from
62 the machine itself via the localhost URL (link below). And you
63 can have some stats and the server status by adding 'server-status'
64 to the server URL, example with the loopback IP address:
65 </p>
67 <pre class="box-share">
68 server root : <a href="http://localhost">http://localhost</a>
69 Server status : <a href="http://127.0.0.1/server-status">http://127.0.0.1/server-status</a>
70 </pre>
72 <h2 id="ftpd">On demand FTP server</h2>
74 <p>
75 This setup guide will use the small Busybox ftpd applet and inetd
76 daemon to run the FTP server only when needed. The setup uses very
77 little system resources and the server can handle hundreds of files.
78 The root directory is where the FTP files are or will be stored.
79 Open inetd.conf with a text editor:
80 </p>
82 <pre>
83 # editor /etc/inetd.conf
84 </pre>
86 <p>
87 And add the following line at the bottom of the config file or
88 search and uncomment the line starting with #ftp:
89 </p>
91 <pre>
92 ftp stream tcp nowait root ftpd ftpd -w /home/share/ftp
93 </pre>
95 <p>
96 We chose to store FTP files in <b>/home/share/ftp</b>, but you are
97 free to use the folder you want. Now restart the inetd daemon to include
98 your new settings:
99 </p>
101 <pre>
102 # /etc/init.d/inetd restart
103 </pre>
105 <p>
106 Finally use a web browser to test the services. As usual, you must
107 use the local IP address of the server or connect from localhost:
108 </p>
109 <pre class="box-share">
110 FTP server: <a href="ftp://localhost/">ftp://localhost/</a>
111 </pre>
113 <h2 id="znc">IRC bouncer setup</h2>
115 <p>
116 The goal is to stay connected to your favorite IRC channels. And playback
117 the IRC messages when you are back online. To setup the IRC bouncer we
118 are going to use a SliTaz RPi base or desktop system combined with
119 <a href="http://wiki.znc.in/ZNC">ZNC</a>. First off install the package
120 and create a configuration file:
121 </p>
123 <pre>
124 # spk-add znc
125 # znc --makeconf
126 </pre>
128 <p>
129 The ZNC server will listen on port 1025 to provide the web interface.
130 To start or kill the ZNC bouncer server:
131 </p>
133 <pre>
134 # znc
135 # killall znc
136 </pre>
138 <h2 id="ntpd">Low resources NTP server</h2>
139 <p>
140 SliTaz Busybox multi-tool binary provides a built-in NTP
141 (Network Time Protocol) client/server. If you have many machines
142 in a local network that need to keep system clocks up-to-date, it
143 may be useful to setup your own NTP server to serve traffic to
144 the web. To start the NTP daemon using '0.pool.ntp.org' server
145 as reference:
146 </p>
148 <pre>
149 # ntpd -l -p 0.pool.ntp.org
150 </pre>
152 <p>
153 You can add this command to the boot script <b>/etc/init.d/local.sh</b>
154 to start the daemon on each boot. Then from another local machine
155 you just have to edit <b>/etc/rcS.conf</b> to set NTPD_HOST with
156 the IP address of your NTP server. You can also test the server with:
157 </p>
159 <pre>
160 # ntpd -q -p 192.168.x.xxx
161 </pre>
164 <!-- Close content -->
165 </div>
167 <div id="footer">
168 &copy; 2014 - <a href="http://www.slitaz.org/">SliTaz GNU/Linux</a>
169 </div>
171 </body>
172 </html>