HomePage :: Categories :: PageIndex :: RecentChanges :: RecentlyCommented :: Login/Register

SLAMPP Documentation

How To

1. Copy to Ram

If you want SLAMPP to load and run faster and have at least 300 MB of RAM you can use the copy2ram command. As SLAMPP boots, when it says boot: type: 'slampp copy2ram'. It will take a minute or two to copy the whole disc to run but once this is done, SLAMPP will run much faster. Also, if you only have one disc drive on your computer and wish to insert another CD/DVD in SLAMPP you can use 'slampp copy2ram' which will copy the disc to RAM and then automatically eject the disc to free up your drive. This is a very handy tool.

2. Boot SLAMPP from your hard drive (installing SLAMPP)

If you want to install SLAMPP on your hard drive, make sure you have a free Linux partition. It could be ext2 or ext3. Then go to your Xfce desktop and double click on the "HD Installation" program icon. Make sure you select the right hard drive partition, you probably don't want to install SLAMPP over another operating system you have. It installs LILO with it, which means that the installation could make Windows, (or other operating systems installed on the drive) unbootable. So you should only do this if you know how to use and edit LILO.

As I don't have SATA or RAID on my PC to test with, I can't confirm that this program would work on those systems. For IDE/ATA, before starting the HD installation program please make sure that the partition you would like SLAMPP to be installed to is unmounted. Otherwise, the program will refuse to work.

For people who would like to do the installation on console, just run the following commands:
# cd /hd_install
# python --device=/dev/hda1

Don't foget to change '/dev/hda1' with the right partition.

3. Use and create a swap partition

If your hard drive already contains a Linux swap partition, SLAMPP will automatically detect it and use it. However, if you don't want to mess around with your drive and create a swap partition, you can create a swap file.

However, if you have another partition, here's how to make a swap file. Type 'fileswap /mnt/hda1/swap.swp 200' for example to make a swap file on the first partition of your first hard drive. The '200' tells it to make a 200MB swap partition. The swap file will not be deleted on a reboot. The fileswap command must be used for each time you boot Slax though. The swap file won't be auto detected.

Note: DO NOT use the fileswap command more than once per boot. Doing so can create major problems.

4. Use Webmin to manage servers and daemons

If you are not that familiar using command line to manage all servers and daemons on SLAMPP, you can administer them through a web browser. Just open the web browser and then type 'https://localhost:10000/'. Then enter 'root' as username and 'slampp' for password.

5. Web development and design

SLAMPP is equipped with tools and applications that support the web development and design processes. At this moment it supports PHP 4, Perl and Python and uses MySQL as database backend. Not to be forgotten, it also includes web server Apache with various mods and plugins that makes your work a little bit easier. Text and WYSIWYG editors like Bluefish, Nvu, and TEA are available to help you writing the scripts or to code. Special treatment for web designers, SLAMPP has some tools that can not be missed like The GIMP, Blender and Inkscape. Shortcuts to all of these applications can easily be found on your dekstop menu.

6. Getting your files on the CD

Do you have websites or other web applications you would like to show to others? Or do you just want to have a good working backup of them on the CD? Then you come to the right solution. SLAMPP helps web masters, developers and designers in promoting their work and makes their clients impressed with that.

Just read the following instructions found on LAMPPIX website to start with this feature. (Note: don't forget to replace folder 'www' with 'html'.)

After that, on console type the following command:
sh /etc/
(In the recent version of SLAMPP, you don't have to run this command manually. It is automatically executed during boot process. Thus, make sure you already include your files on the CD before running SLAMPP.)

All files and database on the CD will be recognized and inserted automatically. Then open the web browser and if anything goes well, your website or web application will be displayed right away. This feature is using the LAMPP scripts provided by LAMPPIX,

What happens if your files have huge size, let's say more than 200 MB, meanwhile your physical RAM is limited?

Then follow the following tips given by Tino Wagner:
This kind of problem can be solved through Instead of packaging everything in a tar package, you do put them in a seperate loopback system. After that, within you mount this filesystem to /var/www/htdocs/live.

To speak with code:

# create the file that contains the filesystem (burn it on the CD), size: 200 MB
dd if=/dev/zero of=htdocs.img bs=1M count=200

# create the filesystem
mkfs.ext2 htdocs.img

# mount it, put in the contents
mount -o loop htdocs.img /mnt
cp $files /mnt
umount /mnt

# put the file on the cd

Then, will need these lines:
mount -o loop /mnt/live/mnt/hdc/html/htdocs.img /var/www/htdocs/live


7. Make your own SSL certificates

Do you have a static IP address? Do you want to have own SSL certicates for your website? Then, this solution will help you out. Just type the following command on console.


8. Firewall

SLAMPP is equipped with three firewall programs which can be used anytime you want. Of course you only need to use one at the time.

To activate FireHOL, just type this command on console: /etc/rc.d/rc.firehol start
To stop: /etc/rc.d/firehol stop

The configuration file, firehol.conf, can be found in /etc/firehol folder. You need to modify this before using FireHOL. If you want to have a quick configuration file for you recent system, you can let FireHOL make automatically one for you. Just type this command on console:

/etc/firehol/ helpme >/tmp/firehol.conf

A temporrary firehol.conf is created. Edit it necessarily and when it is OK, put it in /etc/firehol folder. Restart Firehol, /etc/rc.d.rc.firehol restart. Finished.

FireHOL homepage:

Linux Firewall
Like FireHOL, it can automatically recognize your system and make a rc.firewall file for you. Run this command on console:


A window will be displayed and guide you to manage your firewall system. When you are done, just copy the rc.firewall file to /etc/rc.d folder. Edit the rc.local and add rc.firewall to have firewall activetd during startup process. Don't forget to make the rc.firewall file executable first,

chmod +x rc.firewall


Linux Firewall homepage:

This programs has graphical interface to setup firewall rules and can also be used to share internet connections for home network. Very easy to use and handy if you don't know anything about configuring firewall in Linux.

More information can be found on its homepage,

9. Multimedia

Although SLAMPP is meant for simplying your work to setup a home server, it doesn't mean that it will ignore your multimedia pleasure. Some small multimedia programs have been included on SLAMPP. Unfortunately those programs have no graphical interfaces, thus they must be run on console.

Burn a CD
Go to start menu, select 'BashBurn' on Utilities menu.

Play music
Open a console and then type 'mpg123' or 'amp' to play music. Of course, don't forget to add the file you want to listen to. Or, just use a graphical interface program, Beep Media Player, which can be found on 'Multimedia' menu.

Play Video
Run 'VLC Media Player' which can play various types of video file. It is located on 'Multimedia' menu.

10. Use a module

One of the greatest features of Slax that powers up SLAMPP is the fact that it is modular. That means if it doesn't have something you want, you can easily add it. These additions are called modules. A module is a something you can create or download which has a .mo extension. For example, you can add or a variety of games which weren't included in SLAMPP for size reasons. There are two ways to use a module:

11. Edit Iso

In Linux

First make two working directories, source and master in your recent linux partition in the same directory where you save the iso file.
# mkdir source master

Open SLAMPP iso file you already download before by doing loopback mount to source directory.
# mount -o loop slampp.iso source

All files are now in source directory. Copy those files to master directory created before.
# cp -R --preserve source/* master

Umount source directory and change directory to master.
# umount source
# cd master

You will see that all files in the iso file are now copied to this directory. You can now begin editing the iso. For example, to add a new module, copy the file into modules directory. When finished, you need to run the following scripts to make a new iso. Go to the root of master directory and then type this command:
# ./ /tmp/new-slampp.iso

Wait for a while until a new iso file has been created. It is saved in /tmp directory.
Done. Burn it on the new CD.

In Windows
A great guy named Martijn Starrenburg created MySLAX Creator. Download it at It allows you to modify your Slax/SLAMPP CD in Windows with a wizard-based approach so you can insert and remove modules from the .iso. It is very simple and guides you through all the steps.

12. Uselivemod

To use a module without burning a new CD, use this command. Uselivemod command expects one argument: a full path to the image file you wish to insert to live file system. It doesn't mater where the module is, you can download it while running SLAX/SLAMPP to /root (root's home directory), /mnt/disc0part1 (primary partition of your first hard drive), etc.

Now, to load the module, open a console, (click the black icon on Xfce panel) and type uselivemod /root/ or uselivemod /mnt/hda1/ If all goes well, the computer will pause for a second and display no error. To use the program, check the start menu. If it's not in here, go to the console and use a command to start it (for example, Firefox module is started by executing /usr/share/Firefox/Firefox command). If you don't know the command you should use, explore the content of /mnt/livecd/imgro/ It's a directory which shows only files from your module.

13. Make modules

Making modules is really quite easy. However, it can take up some of your valuable time. Sometimes, if you're lucky, there will already be a Slackware package for the program you want. (Slackware packages end in .tgz) If you find the one you want, download it, and use the command tgz2mo /directory/file.tgz /directory/ You now have an module that can be used with the uselivemod command, or by inserting the module into the .iso. To use the tgz2mo command takes even a slow typer under 2 minutes.

Sometimes, however, you won't be so lucky. There are not Slackware packages for every program out there. For this, you must compile the program first and install it. This can't be done from within the ordinary Slax/SLAMPP. You need a standard distro installed to the hard drive (like Slackware, Mandrake, or Red Hat). Then, make a folder with the name of the module. In here, you will place an exact replication of the files and folders created by the program. For example, in Slax/SLAMPP, check /var/log/packages, and select a file from the list. Open it with TEA or whatever. All the files and directories listed there would need to be copied to the new folder. It may take a really long time, but it's still pretty easy. Now, once you have everything in there, type dir2mo /root/directory/ /root/ You now have a module. This could take a couple hours. (Or a few minutes if your dealing with a small program with few files.)

If you wish to convert an old Slax module with a *.img extension, use the img2mo command.

If you make a good working module, which you think others might benefit from (they probably will) please upload it to the modules section on the Slax/SLAMPP website.

14. Emulation

Use Qemu

Qemu is included in SLAMPP. It allows you to run other operating systems while running SLAMPP. To use it, open a console and type "qemu -m 128 -cdrom /mnt/disc0part1/slampp.iso -boot d -user-net" to start the ISO file. Of course, you need to have the ISO downloaded and called slampp.iso and on the first partition of your primary drive for this particular command to work.

15. Save and restore configuration/settings

To save your settings, run "configsave" command with one argument - the storage location. So type for example configsave /mnt/sda1/ to save your configs in USB flash drive. It will save all changed files from /root, /etc, /home and /var directories.

Then use "configrestore" command to restore your backup. You can also save settings to the root directory of your existing disk partition (for example to /mnt/hda1/ All settings found in the root folder of any of your disk partitions ( under the name will be restored automatically when SLAMPP boots.

This documentation is mainly compiled based on SLAX documentation written by Dustin Wielenga. Some information are based on other sources. Please refer to the links provided in each information.



There are no comments on this page. [Add comment]

Valid XHTML 1.0 Transitional :: Valid CSS :: Powered by Wikka Wakka Wiki
Page was generated in 0.0531 seconds