Bitcart Docs
TwitterTest
  • Introduction
  • Bitcart Basics
    • Use Case
    • Walkthrough
    • Bitcart vs others
    • Try it out
  • Deployment
    • Configurator
    • Docker Deployment
    • Local Deployment
    • Manual Deployment
    • Hardware Deployment
    • Raspberry Pi Deployment
    • Third-Party Hosting
  • Your first invoice
    • Electrum wallet
  • Guides
    • ETH payments plugin
    • Bitcart Plugins Development
    • Default nodes/your own node
    • One domain mode
    • Backups
    • Lightning Network
    • Transaction speed
    • Fiat currencies support
    • Templates
    • Themes
    • Store POS
    • Server management settings
    • Tor
    • Multiple deployments on one server
  • Integrations
    • Shopify
    • WooCommerce
    • WHMCS
    • FOSSBilling
    • Odoo
    • Custom Integration
  • Examples
    • Atomic Tip Bot
    • Templates
  • Support and Community
    • FAQ and common issues
      • General FAQ
      • Server Settings FAQ
      • Deployment FAQ
      • Terminology FAQ
      • Stores FAQ
      • Altcoin FAQ
    • Support
    • Troubleshooting an issue
    • Contribute
    • Community
  • Development
    • Architecture
    • Developing Locally
    • How to add an Altcoin
    • Security Disclosures
Powered by GitBook
On this page
  • 1. Replicating the issue
  • 1.1 Updating the server
  • 1.2 Restarting the server
  • 1.3 Restarting a service
  • 2. Looking through the logs
  • 2.1 Bitcart Logs
  • 3. Finding a solution yourself (Google, FAQ, GitHub issues)
  • 3.1 Bitcart FAQ
  • 3.2 GitHub
  • 3.3 Telegram
  • 4. Asking for help
  • 4.1 Asking the community (general problems)
  • 4.2 Opening an Issue on GitHub (advanced problems)
  • 4.3 Premium Support

Was this helpful?

Edit on Git
Export as PDF
  1. Support and Community

Troubleshooting an issue

PreviousSupportNextContribute

Last updated 1 year ago

Was this helpful?

Facing a problem is never fun. This document explains the most common workflow and steps you should take to identify the issue you're having more easily and hopefully solve it yourself or with community help.

Identifying the problem is crucial.

1. Replicating the issue

First and foremost, try to determine when the issue happens. Try to replicate the problem. Try to update and restart your server to verify you can reproduce your issue. If you think it will describe your issue better, take a screenshot.

1.1 Updating the server

Check your version of Bitcart. If it is much older than the , may resolve the issue.

1.2 Restarting the server

Restarting your server is an easy way to solve many of the most common Bitcart issues. You may need to SSH into your server to restart it.

1.3 Restarting a service

Some issues you may only need to restart a particular service in your deployment. Such as restarting the lets encrypt container to renew the SSL certificate.

sudo su -
cd bitcart-docker
docker restart letsencrypt-nginx-proxy-companion

Use docker ps to find the name of a different service you would like to restart.

2. Looking through the logs

Logs can provide an essential piece of information. In the next few paragraphs, we will describe how to get the log information for various parts of Bitcart.

2.1 Bitcart Logs

If you would like more detailed logs and you're using a Docker deployment, you can view logs of specific Docker containers using the command line.

Run the commands below to print logs by container name. Replace the container name to view other container logs.

sudo su -
cd bitcart-docker
docker ps
docker logs --tail 100 compose-worker-1

3. Finding a solution yourself (Google, FAQ, GitHub issues)

Even though setups differ, the chances that someone else experienced the same issue as yours are pretty high. Take a few moments, Google around and see if you can solve it yourself.

3.1 Bitcart FAQ

3.2 GitHub

3.3 Telegram

Our Telegram group is great for similar issues, other users experienced before you. Search messages for your question

4. Asking for help

If you're unable to solve the problem yourself, do not worry. There's an amid community ready to help you.

The better you describe the problem, the higher are the chances of getting a timely fix. Be concise and provide as much relevant information as possible. Be sure to include the version you're using and describe your deployment setup. Try to explain what you're trying to do and what's the issue. If you can provide the logs. If you think it's relevant, feel free to include a screenshot.

Here's a good example of how to ask a question.

I'm having a problem with XYZ. I can replicate the problem. My Bitcart version is A.B.C.D, and I deployed my server on Digital Ocean by following Docker deployment guide. I've searched through the FAQ and closed GitHub issues, but there's no solution to my problem. My Bitcart Setup is XYZ, and the issue is occurring when I do XYZ. Here are the logs I was able to get from my Bitcart instance. You can see the error in the image I attached.

WARNING

4.1 Asking the community (general problems)

4.2 Opening an Issue on GitHub (advanced problems)

4.3 Premium Support

You can easily access Bitcart logs from the front-end. If you are a server admin, go to Server Management > Server logs () and open the logs file. If you don't know what a particular error in the logs means, make sure to mention it when troubleshooting.

Use docker ps to get the name of container you need. Usually it is the name with prepended to it.

We try to document the most common issues on the . Take a look there and see if your question is recorded.

When there's an advanced technical issue, users usually open an issue on GitHub. Take a look at the Bitcart GitHub repository and browse

The community will not provide extensive support for custom deployments. I.e. Variations of are expected to be used only for development purposes and by users with technical literacy with the ability to resolve deployment and maintenance issues on their own.

For quick answers to fundamental problems, it's best to post a question in one of our .

If you have a custom build setup and are facing a complex problem, so that developers can help you out.

Some community members provide paid support. If you want a quicker help, check out the list of .

docker component
deployment name
Frequently Asked Questions page
search the closed issues
Manual Deployments
communities
open an issue on GitHub
latest version
updating your server
guide
members providing premium support