Welcome to the LXadmin "Host in a box" Client Manual.
Default Login Information:
Contents |
LXadmin "Host in a box" is the only control panel that makes use of Lighttpd and DJBDNS which only uses 8 MB of RAM with a freshly installed system. The control panel itself uses 1 MB of RAM when idle. LXadmin "Host in a box"' is part of LXadmin, the leading light-weight control panel in the industry. The only difference between the two is the use of different daemons.
This lightweight control panel has all of the features included in all leading control panels such as mail, spam filter, PHP, CGI, Perl, SUexec, FTP, MySQL and much much more. You will get to find out more in this document as you read.
There are several ways to access LXadmin:
http://yourdomain:7778 - You can access the control panel through any hosted domain by putting :7778 at the end of the domain.
https://yourdomain:7777 - You can access the control panel securly using SSL through any hosted domain by putting :7777 at the end of the domain.
http://192.168.0.1:7777 or https://192.168.0.1:7778 - You can access the control panel through any IP address allocated to the server. This is useful when your domain transfer has not yet propagated.
A window (top right image) will appear. Enter your username and password (default: admin / admin) and you should have successfully logged in.
To change your password, click client home and then on the top right corner, you will see the password tab. Click on it and fill in your existing password and the new password twice and click Update.
Before adding a new Domain account, you have to create a Plan for the Domain account.
Go to the "Client Home" page Click on "Domain Plans" icon.
In the next page, click the "Add Domain Plan" tab.
Go back to the "Client Home" page and click the "Domains" button
You will now be presented with the list of existing domain accounts. To create a new domain account, click on the "Add Domain" tab on the top
Now enter the following information in the next page to create a domain account:
Domain name Password (twice for confirmation) Contact email address If you want to send a Welcome email automatically to the user, enable the "Send Welcome Message" check box. Select the Plan which you created earlier from the drop down list Now click the "Add" button.
Note: While adding a domain, Lxadmin will automatically create a primary FTP user which would be of the form domaincom .
Note for Windows servers: If your domain name starts with a digit, then an 'a' will be added to the beginning, since windows won't allow creation of pure digit usernames. So if you add a domain '888.com', the primary FTP user would 'a888com'. You can find your Primary FTP user in the 'domain home' page itself, on the header for the second line of icons (the list of icons for site ). Or you can find it in the 'information' tab on the right. You will be able to login to this user using ftp, and password would be the CP password. The primary ftp user password is always synced with the CP password, and if you change your CP password, automatically the primary FTP user password is also changed.
The domain's document root would be /home/httpd/domain.com/httpdocs/www
You will now be able to view the newly added domain in the list of domains under the "Domains" page.
To sign out, click on the Logout button
Lxadmin has the following Directory structure for a Domain account:
By default, there are 4 directories in each domain account's root directory. These are:
To upload files to your domain, you can use an FTP client like FileZilla, CuteFTP, WS_FTP, FlashFXP, etc.
The following will be the general format used by most FTP clients, though the interface could be different among various FTP clients.
To upload files to your domain using the inbuilt File Manager of LxAdmin, click the domain name from the "Domains" page (in the "Clients Home" page).
In the next page, click on the "File Manager" icon.
This is the File Manager for your domain account, using which you can create new files/directories, edit existing files, rename files/directories, change permissions of files/directories, upload files from external servers via HTTP and FTP, Zip a directory, etc.
To create a new email address for your domain account, click the domain name from the "Domains" page (in the "Clients Home" page).
In the next page, under "Mail", click the "Add Mail Account" button
In the next page, enter: the username for your new email address password Disk Space limit, Maximum number of Autoresponders, whether to allow logo change or not
Click the "Add" button to create the new email address.
You can now view the list of email addresses created in the "Manage Mail" page under your domain.
A catch-all email address is used to receive emails that are sent to a non-existant email address. You can either bounce back emails sent to non-existent email addresses or you can "catch" the emails to a default postmaster@yourdomain.com email address
To configure Catchall for a domain account, click the domain name from the "Domains" page (in the "Clients Home" page). Then click the "Configure Catchall" icon
You can select between "Bounce" or "postmaster" to either bounce all emails or to catch them to default postmaster email address.
To setup a forwarder email address which lets you forward incoming emails to another email address, click the "Mail Forwards" icon
In the next page, click the "Add Mail forward" tab on the top
Enter the email address (under your domain) that you wish to forward and then the email address to which you want the emails to be forwarded. Click the "Add" button to create the mail forwarder address.
Note: Mail forwards are virtual email addresses, where mail coming to the address is directly forwarded to the address/script specified here. Please note that a mail account is not created at all, and thus no mail gets stored on the server. If you want to store mails too, you have to create a proper mailaccount and then add forwards from inside it. The Forward To can be a mail address, which would mean that mails coming to the address is transparently sent to it.
To setup an auto-responder which lets you automatically send a pre-defined email message to the sender as a reply to their email,
Now go back to the "Mail Account Home" and click the "Enable Autoresponder" button to enable the new autoresponder
To setup MX Records for your email accounts incase you have a different mail server,
To access Webmail, login to the Webmail installation in the following format:
You will be asked to login before you can access your Webmail account
To create a new database,
Note: Please note that the user for the a mysql database is the same as the mysql db, and also that the domains name is always prefixed at the beginning. So if you add a 'string' mydb, to a domain 'domain.com', the actual database would be domainco__mydb, and user also would be domainco__mydb
So to access the database domainco__mydb, you have to use the same user domainco__mydb, and the password you have supplied.
Please note that the user for the mySQL database is the same as the mySQL database name
So if your database is called: domainco__mydb, then the user also would be domainco__mydb.
To change the password of a database,
To access phpmyadmin,
In the next page, click on the "Phpmyadmin" tab on the top
This will open "phpmyadmin" in a new page
To access the File Manager,
This is the File Manager interface for your domain account. You can click on the directory names to navigate and click on the file names to open the File editor window.
To copy files in the File Manager,
You will notice that the file icon has changed now
Now navigate to the directory where you want to paste the copied file. Click the "Paste" button to paste the file in the new directory.
To move files between directories in the File Manager,
To delete a file in the File Manager,
To change the file permission of a file,
This will open the file permission editor.
Now click the corresponding checkbox to adjust the file permission as you require. If you enable the "Change Permission Recursively" checkbox, it will set the new permission for all files under that directory.
To modify a file in the File Manager,
To create a new FTP account (other than the default account):
You will have to enter a username for the FTP account, password (twice for confirmation) and then select the virtual directory that you would like the new user to access (the directories outside won't be accessible to this user)
To select the virtual directory, you can click on the folder icon, browse the folder and click the "select" link to choose it.
Then click the "Add" button to create the new FTP account
To modify an FTP account,
You can enter a new password or modify the path here.
To delete an FTP account, select the username and click the Delete button
To create an FTP account for a subdomain, when creating an FTP account in the FTP Users page (see 7a), enter the virtual directory parameter of the subdomain.
The subdomain's path will be: /home/httpd/domain.com/httpdocs/subdomains/subdomainname
To create a backup of your domain account,
In the next page, enter a "Backup File Initial String" which will be prefixed to the backup file name. Click "Backup Now" button to start the backup process.
The backup process will start in the background now. You will receive a mail at your contact email when it is completed.
The backup file will appear in the __backup directory of your client area. You can access it by clicking on the 'File Manager' Tab on the top, which will show you the list of backup files completed.
To store backup files in a remote FTP server, you have to configure the remote FTP server first.
In the "Backup Home" page (see 8a), click the "FTP Configuration" tab on the top.
Enter the remote FTP server details here and enable the "Upload files to Remote Server" option and save the configuration.
From now on, when you backup files, it will be uploaded to the remote server. To change back to the local drive, uncheck the "Upload files to Remote Server" option and save the configuration.
To restore an account from a backup file,
There are 2 third party Log Analyzer tools available for LxAdmin - Webalizer and AWStats
Since either one of them can be enabled at a time, you will be able to use Webalizer or AWstats as set by your Administrator.
To view Web Statistics of your domain, click on the "Show Stats" icon
This will open your Statistics page.
You can also protect the Statistics page from the public. To protect the Statistics page,
Enter a username and password for the protected Stats Page user account.
You can use this login for accessing your Statistics pages
Using Error handlers, you can manage and display error pages for your domain. To get started, click on the "Error Handlers" icon.
You can set custom error pages for the following types of errors: 400: Bad Request 401: Authorization Required 403: Forbidden 500: Internal Server Error 404: File Not Found
To set the custom error page for an error type,
To password protect a directory, click on the "Protected Directories" icon.
To add a new scheduler/cron job, click on the "Schduled Tasks" icon
To redirect a website, click on the "Redirects" button
There are two kinds of redirection. You can either redirect a local address to another local address or you can redirect a local address to remote address.
To redirect a directory to another location, click on the "Add Local Redirection" tab.
To redirect a directory to a remote location, click on the "Add Local Redirection" tab.