no-nonsense vps hosting

This article provides some useful technical information for BitFolk VPS customers.

Contents

  1. Community
    1. Wiki
    2. Mailing lists
    3. IRC
    4. More
  2. Network settings
    1. Network - London, UK
  3. Nameservers
  4. Standard facilities
    1. Xen console
    2. Cacti bandwidth/CPU monitoring
    3. Bandwidth, CPU and other statistics
    4. Monitoring
    5. Nagios monitoring
    6. BitFolk Panel
  5. Shared resources
    1. DNS
      1. DNS - London, UK
    2. NTP
      1. NTP - London, UK
    3. apt cache
    4. Software mirrors
    5. SpamAssassin
      1. SpamAssassin - London, UK
    6. Other services
      1. DNS secondaries
      2. Backup mail MX
      3. Local backups
    7. Referral scheme
    8. Frequently asked questions
      1. About BitFolk
        1. Does BitFolk have a renewable energy statement?
      2. Your BitFolk Account
        1. I've forgotten my password for the console / Cacti / Monitoring / Panel, can you reset it?
        2. Which piece of actual hardware is my VPS hosted on?
      3. Xen Shell and console
        1. How do I get out of my console and back to the Xen Shell menu?
      4. Billing
        1. If I'm paying by bank transfer, what reference should I use?
      5. Local Backups Service
        1. How do the backups work?
        2. I don't like the default backup schedule, can I pick my own?
        3. How do I access my backups?
        4. Can you export my backups to somewhere else?
        5. I've run out of disk space, can you make my backup space writable?
        6. Does it really need to run as root?
        7. How do I find out the current usage and configuration for my backups?
      6. Nagios Monitoring Service
        1. I'm getting alerts from Nagios. How do I access the web interface?
        2. Which IP addresses will Nagios checks come from?
        3. Why am I receiving alerts for this unfamiliar host/service?
      7. General OS Issues
        1. Are my bandwidth limits outbound or inbound or both?
        2. Does my local traffic get counted towards my allowance?
        3. Why do my Cacti bandwidth graphs seem to be backwards (i.e. inbound traffic shows as outbound and vice versa)?
        4. Why is my Cacti graph empty and the figures read "nan"?
        5. Do I need to synchronise my clock like I would on a normal server?
        6. Can/should I run my own firewall?
        7. Why don't I see a change in my VPS's RAM when I reboot like you told me to?
        8. Why don't I see a new kernel after I've rebooted?
        9. I've been told I have an open recursive nameserver. What's the problem?
        10. How do I restrict rsync-over-ssh connections from BitFolk so they can only do rsync?
        11. When updating libc, the update fails and I get messages regarding /lib/tls
        12. Can I compile my own kernel?
        13. My VPS is not responding, is there anything I can do?
        14. Can I upgrade or downgrade my plan part way through the payment period?
        15. Does BitFolk support IPv6?
        16. I've forgotten my root password! How do I reset it?
        17. Why is my swap a swap file, not a swap device?
        18. Why has time-based filesystem check (fsck) been disabled?
      8. Debian-specific
        1. What should I put in my /etc/apt/sources.list file?

Community

Sometimes the best help can be found in the community of BitFolk users. If you can't find the information you need in this document then here are some other places you could try asking.

Wiki

We have a wiki which allows customers to edit any page. This is ideal for sharing guides and other contributed documentation. Over time more of this page will be migrated to wiki articles.

Mailing lists

The preferred place for discussion amongst BitFolk customers is the users mailing list. The list has a public, searchable archive.

Please note that emails sent to the list are deemed to be for publication without condition, and the information will be available in perpetuity. We are not responsible for removing or otherwise concealing your communication after you caused it to become public.

We will usually edit or remove information from the list archives only in the event of an inadvertent disclosure of confidential information; however, a sender's contact information (name, email address, phone number, etc.) does not fall into that category.

The users list is also the primary place that any important notices, planned downtime and outage post-mortems will be posted, so it's recommended that all customers be subscribed to it.

IRC

There is a vibrant user community on IRC, although this is an unofficial, largely unmoderated environment recommended only for those with a thick skin, and probably not suited for minors. Or possibly anyone.

The channel #BitFolk can be found on irc.bitfolk.com. You can find more information about this IRC channel on our wiki.

More

There's a few other bits and pieces of social media such as Twitter, Facebook and Last.fm. You'll find the details listed on the contacts page.

Network settings

Network - London, UK

In CIDR notation the network is 85.119.80.0/21

Nameservers

You can run your own nameserver, but resolvers are supplied. See Shared resources.

Standard facilities

BitFolk customers have access to a number of free services.

Xen console

Xen console (actually Steve Kemp's Xen Shell) is provided so that you may start, stop and access the console of your VPS even when it is not running or has no networking capability.

Documentation for this feature is now maintained in our customer wiki.

Cacti bandwidth/CPU monitoring

Our Cacti installation was retired in November 2020 in favour of a more advanced system based upon Prometheus and Grafana.

Bandwidth, CPU and other statistics

More information about the statistics available to customers is available on our wiki.

Cacti is used to gather and display real-time stats of your VPS's bandwidth and CPU usage. There are two ways to access Cacti:

Monitoring

Information about our free monitoring service has now moved to our wiki.

Nagios monitoring

Our Nagios instance was decommissioned in December 2018 and was replaced with a different system. This entry remains only so that links do not break.

BitFolk Panel

The BitFolk Panel is still under development, but contains a lot of useful information about your BitFolk account, including your VPS configuration, backup settings, and your invoice history. If you have any feature requests we'd love to hear about them, either directly to support or discussed on the users mailing list.

The login credentials for the BitFolk Panel are the same ones used for the console, Cacti and Nagios, and can be found in /root/PASSWORDS when your VPS is set up.

Shared resources

Information about shared resources has now moved to an article on our wiki.

DNS

Information about DNS has now moved to an article on our wiki.

DNS - London, UK

NTP

Information about NTP has now moved to an article on our wiki.

NTP - London, UK

apt cache

Information about our apt cache has now moved to an article on our wiki.

Software mirrors

Information about our software mirrors has now moved to an article on our wiki.

SpamAssassin

Information about our SpamAssassin has now moved to an article on our wiki.

SpamAssassin - London, UK

Other services

DNS secondaries

Information about the DNS secondary service has now moved to an article on our wiki.

Backup mail MX

If your primary MX is hosted by us then we are happy to offer a backup MX in the US, with antispam and antivirus setup. This will be free of charge provided you do not receive hundreds of thousands of emails per month across all your domains.

This free service is intended for customers with just a couple of domains who do not wish to go to the trouble of providing their own backup mail infrastructure. As such it is limited to 10 domains per customer. If you need backup MX and/or antispam/antivirus for more domains then we suggest you purchase another VPS; alternatively we can recommend some companies specialising in these services.

Please also bear in mind that you will not be able to affect the antispam or antivirus settings of BitFolk's mail servers.

Local backups

Information about our backups service has been moved to an article on our wiki.

Referral scheme

There is a referral scheme in operation to encourage you to bring in new customers. Make sure to get them to quote your VPS name when they make their first payment.

Frequently asked questions

About BitFolk

Does BitFolk have a renewable energy statement?

Yes, it is located on our wiki.

Your BitFolk Account

I've forgotten my password for the console / Cacti / Monitoring / Panel, can you reset it?

Most BitFolk services that have a login are using centralized authentication. There's an email password reset feature linked from the Panel's login screen. It will ask you for your account name and then send an authorization link by email to the address we have on file for you. Once you follow the link, your password will be reset to a random string which it will tell you.

If you don't have access to the email address that we have on record for you, e.g. because it's out of date or because it's hosted on your VPS which is currently down, you're going to have to submit a support ticket by email. If your service is down and not knowing your password is preventing you from fixing it, please feel free to send an SMS to the emergency contact telephone number.

Which piece of actual hardware is my VPS hosted on?

There's several ways to tell.

Xen Shell and console

How do I get out of my console and back to the Xen Shell menu?

Documentation for this answer is now maintained in our customer wiki.

Billing

If I'm paying by bank transfer, what reference should I use?

The Billing section of our Panel has a unique reference you can use so that we can recognise your bank payment.

If you don't or can't use this reference then we will have to guess at the identity of the payee when the payment comes in. If we can't guess then we may have to wait until you contact us to tell us you have paid.

Local Backups Service

How do the backups work?

Documentation for this answer is now maintained in our customer wiki.

I don't like the default backup schedule, can I pick my own?

Documentation for this answer is now maintained in our customer wiki.

How do I access my backups?

Documentation for this answer is now maintained in our customer wiki.

Can you export my backups to somewhere else?

Documentation for this answer is now maintained in our customer wiki.

I've run out of disk space, can you make my backup space writable?

Documentation for this answer is now maintained in our customer wiki.

Does it really need to run as root?

Documentation for this answer is now maintained in our customer wiki.

How do I find out the current usage and configuration for my backups?

Documentation for this answer is now maintained in our customer wiki.

Nagios Monitoring Service

This service has now been decomissioned and replaced with a new monitoring service, which is documented on our wiki. This and the sections below only remain to prevent links from breaking.

I'm getting alerts from Nagios. How do I access the web interface?

Documentation for this answer is now maintained in our customer wiki.

Which IP addresses will Nagios checks come from?

Documentation for this answer is now maintained in our customer wiki.

Why am I receiving alerts for this unfamiliar host/service?

Documentation for this answer is now maintained in our customer wiki.

General OS Issues

Are my bandwidth limits outbound or inbound or both?

For our UK network there is currently an excess of inbound bandwidth, therefore you can have twice as much inbound as outbound. e.g. if your plan allows 1,000GB data transfer then this corresponds to 1,000GB out (people downloading from your VPS) and 2,000GB in (people uploading to your VPS). Excess data transfer is still charged the same.

Does my local traffic get counted towards my allowance?

No. Only traffic destined for or coming from outside of the local network (85.119.80.0/21, 2001:ba8:1f1::/48) will be counted. This is great incentive for you to make use of the shared resources on offer such as an APT cache and recursive DNS.

Why do my Cacti bandwidth graphs seem to be backwards (i.e. inbound traffic shows as outbound and vice versa)?

The graphs are plotted from the point of view of the host machine where each VPS has a network interface going to it. Therefore traffic going to your server is going out from the host, and data coming from your server is coming in to the host.

Just reverse the directions if you want to think about from the point of view of your own server.

Why is my Cacti graph empty and the figures read "nan"?

"nan" stands for "not a number" i.e. "no results". If your VPS has only just been provisioned then this is completely normal - 3 readings are necessary to draw the initial graph, and as readings are done every 5 minutes the daily graph will remain empty for at least the first 15 minutes.

The weekly, monthly and yearly graphs are built from the daily one and will stay empty until the daily graph has the required amount of data: 30 minutes, 2 hours and one day respectively.

If your VPS has been in use for some time and the graphs are empty then there is possibly a problem; please contact support.

Do I need to synchronise my clock like I would on a normal server?

Yes. Installs that we provide are set up to use NTP to sync the clock.

A list of recommended NTP servers appears above.

Can/should I run my own firewall?

You can, and you probably should. Whatever you normally use should work. iptables works fine for Linux, for example. Don't forget to firewall IPv6 as well!

Why don't I see a change in my VPS's RAM when I reboot like you told me to?

We can now reduce your memory without you needing to reboot your VPS, and are able to set the memory at next boot for increases, so this question is obsolete, This entry emails only so that links do not break.

Why don't I see a new kernel after I've rebooted?

Rebooting does now run a new bootloader and will show whatever kernel entries the bootloader is aware of, so this question is obsolete. This entry emails only so that links do not break.

I've been told I have an open recursive nameserver. What's the problem?

Please see the Open recursive nameservers article.

How do I restrict rsync-over-ssh connections from BitFolk so they can only do rsync?

If BitFolk is rsyncing your files for backup or DNS purposes then you may wish to restrict these connections so that they may only use rsync, rather than allow them to have a complete interactive login. Please do not try to set this up until after the service in question is known to be working properly, as this makes debugging SSH key logins much more difficult.

For an overview on the subject please read Using Rsync and SSH, particularly the section on restricting to rsync.

When updating libc, the update fails and I get messages regarding /lib/tls

There is no longer any supported Linux distribution which is affected by this issue, so this entry remains only for historical purposes.

/lib/tls is a directory of libraries (usually owned by the libc package) which are incompatible with Xen.

When your VPS is provisioned these will be moved to /lib/tls.disabled, an empty file created at /lib/tls and then made unreadable and immutable. This is what probably causes your upgrade procedure to fail, but it is necessary because otherwise an update to libc would replace the incompatible TLS libraries.

The easiest way to deal with this is probably to remove everything to do with /lib/tls:

$ sudo chattr -i /lib/tls
$ sudo rm -fr /lib/tls /lib/tls.disabled

Now do your update as normal, and then take care to disable the TLS libraries afterwards:

$ sudo mv /lib/tls /lib/tls.disabled
$ sudo touch /lib/tls
$ sudo chmod 0 /lib/tls
$ sudo chattr +i /lib/tls

Fortunately libc updates are rare, and newer releases such as Debian Etch and Ubuntu Edgy contain a libc6-xen package which is compatible.

Can I compile my own kernel?

Yes; the kernel in use on boot is determined by your grub configuration, so as long as you can put a correctly-configured kernel with Xen support in there it should work. You may find it easiest to adapt your distribution's existing Xen kernel package. Typical reasons for compiling ones own kernel are to change the HZ value for example.

BitFolk however cannot support this sort of advanced usage so you should be very sure of what you are doing.

My VPS is not responding, is there anything I can do?

Most likely yes! If you can't access your VPS over the network then the first thing you should do is connect to your Xen console. Most of the time this turns out to be a misconfiguration or some other problem local to your VPS such as you using up all your RAM and swap. Your best chance of recovering from that is with the console command.

If you can't even log in over the console then the next thing to try is probably the usual Linux SysRq commands, using ctrl-o and then the command character. e.g. ctrl-o h will show the SysRq help. Your goal will be to try to get the kernel to cleanly unmount its filesystem(s) before you reboot.

If you have no luck with this approach then as a last resort you can use the destroy command. Please be aware that as the name implies this will instantly kill your VPS, will not cleanly unmount any filesystems, and so you would expect to see a fsck on next boot and may experience data corruption. If the VPS will not shutdown or reboot normally then it would be our only option anyway, so this at least will save you having to contact support.

Once your VPS is shutdown or destroyed you will be able to boot it again. Xen Shell runs inside GNU Screen so you may find it convenient to create a new screen (ctrl-a c) to run the console command in. That way you can watch your VPS shutdown/boot while issuing Xen Shell commands in the other window.

If none of this helped, or if you cannot even connect to the Xen console, please contact support and we'll do our very best to help you.

Can I upgrade or downgrade my plan part way through the payment period?

Documentation for this answer has now been moved to our customer wiki.

Does BitFolk support IPv6?

Yes. Native IPv6 connectivity is available by default.

It is not currently possible (without some gross hacks) to run an IPv6-only VPS at BitFolk as some BitFolk services are still only available via IPv4, but it is a goal to remedy this.

Please note that most Linux distributions will automatically configure IPv6 addresses and many daemons already support IPv6; those customers firewalling IPv4 will also want to firewall (or disable) IPv6.

An auto-configured IPv6 interface will look something like this:

$ /sbin/ip -6 addr show dev eth0
2: eth0:  mtu 1500 qlen 1000
    inet6 2001:ba8:1f1:f004:a800:ff:fe6a:380c/64 scope global dynamic
       valid_lft 2591934sec preferred_lft 604734sec
    inet6 fe80::a800:ff:fe6a:380c/64 scope link
       valid_lft forever preferred_lft forever

This indicates that the customer has been assigned 2001:ba8:1f1:f004::/64. All initial BitFolk IPv6 assignments are one /64 per customer; if this is insufficent then a further /56 can be routed to you.

If auto-configuration is not desired then you can configure your operating system to not listen to router advertisements and then statically configure any address(es) in the range, except ...::1/64. For example the above customer can use any address between 2001:ba8:1f1:f004::2/64 and 2001:ba8:1f1:f004:ffff:ffff:ffff:ffff/64.

I've forgotten my root password! How do I reset it?

  1. Log in to your Xen Shell console via ssh username@username.console.bitfolk.com.
  2. Shut down your VPS with the shutdown command.
  3. Start up the rescue environment with the rescue command.
  4. Mount your root filesystem somewhere inside the rescue VPS. Available block devices are listed in /proc/partitions so it will be one of those.
  5. Either edit the shadow file (so if you mounted your filesystem on /mnt, you'd edit /mnt/etc/shadow) to put a new (or an empty) password hash in, or use chroot to change into your VPS's root filesystem and issue passwd root to change root's password.
  6. halt the rescue environment.
  7. boot your VPS.

Why is my swap a swap file, not a swap device?

We now provide a standard 1GiB dedicated swap disk, so this answer is obsolete. The text below is of historical interest only.

We used to give swap as a separate device, but people kept asking for it to be bigger or smaller than we provided. In Linux, swap files in the 2.6.x kernel have identical performance to swap devices, and having one fewer block device is simpler, so we switched to providing VPSes with swap files instead.

Why has time-based filesystem check (fsck) been disabled?

The ext4 filesystem (which is in use by default at BitFolk) is traditionally set to require a fsck at boot time based on both elapsed time since last fsck and the number of mounts since last fsck. Since late April 2010 we have been disabling the time-based fsck for new VPS installs. Our rationale for this is as follows.

When one of BitFolk's host servers is rebooted, either for scheduled maintenance or because of some problem, most of the customer VPSes on it will not have been rebooted in a long time. With a typical check interval of 6 months, almost all of the customer VPSes will decide to do a fsck all at once on next boot. The IO load from 40-50 virtual machines all doing fsck at once is considerable.

With time-based fsck disabled, the fsck on boot will only happen if the mount count goes above the maximum. You can see the values like this:

$ sudo tune2fs -l /dev/xvda | grep -i 'check\|mount count'
Mount count: 2
Maximum mount count: 34
Last checked: Sat Oct 17 09:10:33 2009
Check interval: 0 ()

(replace /dev/xvda with whatever your partitions are – see /proc/partitions)

If you weren't planning to reboot every 6 or so months anyway then the time-based fsck probably wasn't doing anything for you. You may like to consider using:

$ sudo shutdown -r -F

to do a reboot and force a filesystem check on boot, at times that are convenient to you.

Another trick is to do a fsck in read-only mode on an online, mounted filesystem:

$ sudo fsck.ext4 -fvn /dev/xvda 

This will tell you if the filesystem requires a modification to fix it, without actually doing anything. You can then decide whether to reboot to do a normal fsck.

If you really don't like the idea of disabling time-based fsck then it's easy to turn it back on, and we don't mind you doing so if you feel strongly about it. Here's how:

$ sudo tune2fs -i 6m /dev/xvda

This sets the interval to 6 months. You can also use a postfix of w for weeks or d (or no postfix at all) for days.

Debian-specific

(Mostly applicable to Ubuntu and other Debian-based distributions also.)

What should I put in my /etc/apt/sources.list file?

We've set up a local apt-cacher so that packages only need to be downloaded once. See the apt-cacher page for more information.

Ready to create your own VPS?

Start customising your new VPS now →
Bitty the Robot