asmBB Forum : How to download, compile and install asmBB
<img src="Wh ÎÿsèÿD://asmbb.org/images/title.svg" alt="Title img">
<h1>AsmBB is fast and lightweight web forum engine</h1>
tag:asmbb.org,2022-11-19:Thread82022-11-16T12:42:44Zadmin on How to download, compile and install asmBBtag:asmbb.org,2022-11-19:Post132022-11-16T12:42:44Z
<h2>AsmBB advanced manual
</h2>
<h3>Downloading the sources of AsmBB.
</h3>
<p><strong>AsmBB</strong> is hosted in <a href="https://fossil-scm.org/">fossil version control system</a> on <a href="https://asm32.info/fossil/repo/asmbb">AsmBB repository</a>.
</p>
<p>The best way to get the source code of AsmBB is to clone the repository (you will need fossil installed on your system).
</p>
<p>Type in the console:
</p>
<pre><code class="">$ fossil clone https://asm32.info/fossil/repo/asmbb /%path_to_repositories%/asmbb.fossil
</code></pre>
<p>Then create checkout:
</p>
<pre><code class="">$ mkdir asmbb
$ cd asmbb
$ fossil open /%path_to_repositories%/asmbb.fossil
</code></pre>
<p>Now you have all files from the branch trunk in the <em>asmbb directory. If you want the code from some other branch, execute:
</em></p>
<pre><code class="">$fossil co %BRANCH_NAME%
</code></pre>
<h3>Downloading the dependencies.
</h3>
<p>In order to compile AsmBB you will need:
</p>
<p>The sources of <a href="https://fresh.flatassembler.net/fossil/repo/fresh/index">FreshLibDev</a>
</p>
<p>Cloning and checkout is very similar to the same procedure for AsmBB:
</p>
<pre><code class="">$ fossil clone https://fresh.flatassembler.net/fossil/repo/fresh /%path_to_repositories%/Fresh.fossil
$ mkdir FreshLibDev
$ cd FreshLibDev
$ fossil open /%path_to_repositories%/Fresh.fossil FreshLibDev
</code></pre>
<h3>Installation and settings of Fresh IDE:
</h3>
<p>The installation of Fresh IDE is described in details in the <a href="https://fresh.flatassembler.net/index.cgi?page=content/articles/0_advanced_setup.txt">Fresh IDE setup manual</a>.
</p>
<p>After installing Fresh IDE, set the lib alias (Options|IDE options|Aliases) to point to the "FreshLibDev/freshlib/" directory.
</p>
<h3>Compiling AsmBB
</h3>
<p>Now you are ready to compile AsmBB.
</p>
<p>Open the file AsmBB/source/engine.fpr (the project file) in Fresh IDE and press Ctrl+F9.
</p>
<p>If the compilation complete without errors, the compiled binary is AsmBB/www/engine.
</p>
<h3>Deploying AsmBB on the server.
</h3>
<p>Needed files that need to be placed on the server are:
</p>
<p><strong>templates/</strong>* - contains all HTML templates needed by the engine.
</p>
<p><strong>images/</strong>* - contains all images needed by the forum. The specific images are only depending on the templates and the .css files. The engine itself does not hardcode the image files.
</p>
<p><strong>all.css</strong> - contains the CSS code. The name of this file is specified in templates/main_html_start.tpl and may vary if the templates has been changed.
</p>
<p><strong>engine</strong> - the forum engine.
</p>
<p><strong>libsqlite3.so</strong> - the SQLite library. In order to work on 64bit servers, this file has been statically linked and compiled with musl library.
</p>
<p><strong>ld-musl-i386.so</strong> - the <a href="https://musl.libc.org/">MUSL</a> dynamic linker, needed for loading libraries on 64bit servers. </p>
adminadmin on How to download, compile and install asmBBtag:asmbb.org,2022-11-19:Post122022-11-16T12:35:17Z
<p><strong>AsmBB</strong> is high performance web forum software, written entirely in assembly language. It is very lightweight, but provides decent set of features and ultimate performance.
</p>
<p>The current version of AsmBB is <strong>v2.9</strong>
</p>
<p>The easiest way to install AsmBB is to download the binary package.
</p>
<p>Download the package from this link: <a href="https://asm32.info/fossil/repo/asmbb/doc/trunk/install/asmbb.tar.gz">asmbb.tar.gz</a> (it is permanent link to the latest trunk version of the package).
</p>
<p>It contains the file <strong>install.txt</strong> with directions for installation on shared hosting.
</p>
<p>For installation on dedicated servers or VPS, reference the following article: "<a href="/how-to-install-asmbb-on-vps-with-nginx-and-systemd.6/">How to install AsmBB on vps with nginx and systemd</a>"
</p>
<p>The content of install.txt follows:
</p>
<blockquote><header>install.txt</header><h2>AsmBB installation guide
</h2>
<h3>Preface
</h3>
<p>This package contains the forum engine AsmBB, which is high performance web forum engine, written entirely in assembly language.
</p>
<p>This package is the binary release of the engine, but it is free open source distributed under <strong>EUPL license</strong> (the file License.txt) and you can download the source code from the source repository (<a href="https://fossil-scm.org/home/doc/trunk/www/index.wiki">fossil</a>), located on:
</p>
<p><strong>http://asm32.info/fossil/repo/asmbb/</strong>
</p>
<h3>Prerequisites
</h3>
<p>In order to use AsmBB you will need running web server, supporting <strong>FastCGI protocol</strong>. Most web servers will do the job. Particularly <strong>Apache</strong> or <strong>Nginx</strong>.
</p>
<p>You can install AsmBB on local server (for testing) on shared hosting or any other hosting option.
</p>
<p>The only mandatory condition is that the server must run on x86 or x86-64 Linux platform and the <strong>fastcgi</strong> module should be enabled (most servers running <strong>php</strong> has it enabled anyway).
</p>
<p>AsmBB is self sufficient and does not requires any libraries or databases installed on the server.
</p>
<p>In order to send mails to the forum users, AsmBB will need the address and port number of <strong>SMTP server</strong> that is accessible from your web server without authentication. Most <strong>SMTP servers</strong> provided by the web hosting will not need authentication if connected from the local network (i.e. the web site engine).
</p>
<h3>Installation
</h3>
<p>First unpack the files in temporary directory. Depending on your server edit the file <strong>.htaccess</strong> (Apache) or <strong>lighttpd.conf</strong> (lighttpd) - Change the "_FULL_PATH_TO_DOCUMENT_ROOT_HERE_" placeholder to the real path to your document root (it depends on the web server settings).
</p>
<p>IMPORTANT: Ensure that the uploaded files have the proper permissions for the www-data user (the web server user). The www-data user will need writing permissions in the DOCUMENT_ROOT directory. The executable files must have <strong>755</strong> permissions.
</p>
<p>IMPORTANT FOR Lighttpd: The provided in the package file "lighttpd.cond is just an example. Lighttpd keeps its config files in: "/etc/lighttpd/lighttpd.conf" and all files in "/etc/lighttpd/conf-enabled/" directory. You will need to merge the example config in the existing files in one or another consistent way and then restart lighttpd.
</p>
<p>If using another web server, prepare the configuration by yourself.
</p>
<p>Upload all files (directories and <strong>symlinks</strong>) of the package to the document_root directory of your web server.
</p>
<p>IMPORTANT: The package may contain some <strong>symlinks</strong>. Ensure they are uploaded together with the files. Notice, that <span class="underlined">FTP can't upload symlinks</span>.
</p>
<p>The simplest way is to upload the tarball to the server and unpack there by using cpanel tools, ssh or any other way.
</p>
<p>Read the chapter <strong>"Easy Installation on Apache by FTP"</strong> below, about how to make the proper upload by FTP.
</p>
<p>Test the forum by loading the web site in your favorite browser.
</p>
<p>As simple as that.
</p>
<h3>Easy Installation on Apache by FTP
</h3>
<p>Download the package "unpack.tar.gz" from:
</p>
<p><a href="http://asm32.info/fossil/repo/asmbb/doc/trunk/install/unpack.tar.gz">http://asm32.info/fossil/repo/asmbb/doc/trunk/install/unpack.tar.gz</a>
</p>
<p>Untar it. There are 2 files: ".htaccess" and "unpack.sh";
</p>
<p>Upload these 2 files and "asmbb.tar.gz" on the server document_root via ftp or any other way. The root directory must contain these 3 files:
</p>
<p>.htaccess asmbb.tar.gz unpack.sh
</p>
<p>Load in some browser: http://your_web_size/unpack.sh
</p>
<p>The script will unpack all files, prepare the proper .htaccess file and redirect you to the new created forum working in setup mode.
</p>
<h3>Introduction to the forum configuration.
</h3>
<p>When run for the first time, AsmBB will create an empty database for the forum - a file, named board.sqlite in the root directory.
</p>
<p>Until there is no users registered, AsmBB will run in setup mode, displaying the administrator user creation dialog.
</p>
<p>The registration of the admin user will not need email activation and is pretty liberal about the quality of the password. But you as an administrator of the forum, better choose strong password and whatever nickname you prefer.
</p>
<p>After creation the administrator user, the access to the forum settings is restricted only for the users with administrator privileges.
</p>
<p>Set the SMTP server and other forum parameters in the settings page.
</p></blockquote>
admin