{"id":5758,"date":"2021-06-01T23:12:58","date_gmt":"2021-06-01T23:12:58","guid":{"rendered":"https:\/\/www.geekdecoder.com\/?p=5758"},"modified":"2021-06-01T23:12:58","modified_gmt":"2021-06-01T23:12:58","slug":"install-ipfs-on-debian","status":"publish","type":"post","link":"https:\/\/www.qbytes.cloud\/index.php\/2021\/06\/01\/install-ipfs-on-debian\/","title":{"rendered":"Install IPFS on Debian 10 Buster"},"content":{"rendered":"

\"\"<\/a>Installing IPFS through the command-line is handy if you plan on building applications and services on top of an IPFS node. This method is also useful if you’re setting up a node without a user interface, usually the case with remote servers or virtual machines. Using IPFS through the command-line allows you to do everything that IPFS Desktop can do, but at a more granular level since you can specify which commands to run.<\/p>\n

You can install as root or in Debian add or modify a user for sudo.<\/p>\n

By default sudo is not installed on Debian, but you can install it. First login as root.
\nInstall sudo by running:<\/p>\n

# apt-get install sudo -y\n<\/pre>\n
Add a user ipfs ( or use one of your own users).<\/p>\n
# adduser ipfs\nAdding user `ipfs' ...\nAdding new group `ipfs' (1000) ...\nAdding new user `ipfs' (1000) with group `ipfs' ...\nCreating home directory `\/home\/ipfs' ...\nCopying files from `\/etc\/skel' ...\nNew password:\nRetype new password:\npasswd: password updated successfully\nChanging the user information for ipfs\nEnter the new value, or press ENTER for the default\n        Full Name []: IPFS\n        Room Number []:\n        Work Phone []:\n        Home Phone []:\n        Other []:\nIs the information correct? [Y\/n] y\n<\/pre>\n
# usermod -aG sudo ipfs\n<\/pre>\n
Make sure your sudoers file have sudo group added. Run:<\/p>\n
# visudo\n<\/pre>\n
Allow members of group sudo to execute any command<\/p>\n
%sudo   ALL=(ALL:ALL) ALL\n<\/pre>\n
Copy ssh keys to ipfs user from root(optional step)<\/p>\n
# cp -r .ssh\/ \/home\/ipfs\/\n<\/pre>\n
Set permissions<\/p>\n
 # chown -R ipfs:ipfs \/home\/ipfs\/.ssh\/\n<\/pre>\n
You need to relogin or reboot device completely for changes to take effect.<\/p>\n
IPFS Install
\nLogin as the IPFS user.<\/p>\n
Download the Linux binary from dist.ipfs.io<\/p>\n
$ wget https:\/\/dist.ipfs.io\/go-ipfs\/v0.8.0\/go-ipfs_v0.8.0_linux-amd64.tar.gz\n<\/pre>\n
Unzip the file:<\/p>\n
$ tar xvfz go-ipfs_v0.8.0_linux-amd64.tar.gz\ngo-ipfs\/install.s\ngo-ipfs\/ipfs\ngo-ipfs\/LICENSE\ngo-ipfs\/LICENSE-APACHE\ngo-ipfs\/LICENSE-MIT\ngo-ipfs\/README.md\n\n<\/pre>\n
Move into the go-ipfs folder and run the install script:<\/p>\n
$ cd go-ipfs\n<\/pre>\n
$ sudo .\/install.sh\nMoved .\/ipfs to \/usr\/local\/bin\n<\/pre>\n
Move to HOME<\/p>\n
cd ..\n<\/pre>\n
Test that IPFS has installed correctly:<\/p>\n
$ ipfs --version\nipfs version 0.8.0\n<\/pre>\n
Initialize the repository<\/p>\n
ipfs stores all its settings and internal data in a directory called the repository. Before using IPFS for the first time, you\u2019ll need to initialize the repository with the “ipfs init” command. There are 2 was to Initialize. Local and Data Center Installations. If you are in a Data Center skip to the Datacenter Installation below.<\/p>\n
Local Installation (Only for local installations):<\/p>\n
$ IPFS_PATH=~\/.ipfs ipfs init\n<\/pre>\n
Datacenter Installation:
\nIf you are running on a server in a data center, you should initialize IPFS with the server profile. Doing so will prevent IPFS from creating a lot of data center-internal traffic trying to discover local nodes:<\/p>\n
$ IPFS_PATH=~\/.ipfs ipfs init --profile server\ngenerating ED25519 keypair...done\npeer identity: 12D3KooWKQn2n8Yee75qJqUHAc6cpfZypby2qhczWhXYx2k4FEtM\ninitializing IPFS node at \/home\/username\/.ipfs\nto get started, enter:\n\n        ipfs cat \/ipfs\/QmQPeNsJPyVWPFDVHb77w8G42Fvo15z4bG2X8D2GhfbSXc\/readme\n<\/pre>\n
The hash after peer identity is your node\u2019s ID and will be different from the one shown in the above output. Other nodes on the network use it to find and connect to you. You can run ipfs id at any time to get it again if you need it.<\/p>\n
Now, run the command in the output of ipfs init. The one that looks like this…<\/p>\n
$ ipfs cat \/ipfs\/QmQPeNsJPyVWPFDVHb77w8G42Fvo15z4bG2X8D2GhfbSXc\/readme\n<\/pre>\n
You should see something like this:
\n\"\"<\/a><\/p>\n
You can explore other objects in the repository. In particular, the quick-start directory which shows example commands to try:<\/p>\n
$ ipfs cat \/ipfs\/QmQPeNsJPyVWPFDVHb77w8G42Fvo15z4bG2X8D2GhfbSXc\/quick-start\n<\/pre>\n
Take your node online<\/p>\n
Option 1<\/p>\n
Once you’re ready to join your node to the public network, run the ipfs daemon in another terminal<\/strong> and wait for all three lines below to appear to know that your node is ready. This is a way to manually start it. See below to have the service set up to start automatically.<\/p>\n
$ IPFS_PATH=~\/.ipfs ipfs daemon\nInitializing daemon...\ngo-ipfs version: 0.9.0\nRepo version: 11\nSystem version: amd64\/linux\nGolang version: go1.15.8\nAPI server listening on \/ip4\/127.0.0.1\/tcp\/5001\nWebUI: http:\/\/127.0.0.1:5001\/webui\nGateway (readonly) server listening on \/ip4\/1127.0.0.1\/tcp\/8080\nDaemon is ready\n<\/pre>\n
Make a note of the TCP ports you receive. If they are different, use yours in the commands below.<\/p>\n
Now, switch back to your original terminal. If you\u2019re connected to the network, you should be able to see the IPFS addresses of your peers when you run:<\/p>\n
$ ipfs swarm peers\n<\/pre>\n
Option 2
\nIt would be better to start IPFS daemon as a service instead of the terminal attached process.
\nYou can create a service so that the daemon runs automatically. Edit user profile for setting env variables:<\/p>\n
Create systemctl service for ipfs:<\/p>\n
$ sudo nano \/etc\/systemd\/system\/ipfs.service\n<\/pre>\n
Add the following (Change User and Group Accordingly):<\/p>\n
[Unit]\nDescription=IPFS Daemon\nAfter=syslog.target network.target remote-fs.target nss-lookup.target\n\n[Service]\nType=simple\nExecStart=\/usr\/local\/bin\/ipfs daemon --enable-namesys-pubsub\nUser=ipfs\n[Install]\nWantedBy=multi-user.target\n<\/pre>\n
restart systemctl daemon so it finds new service:<\/p>\n
$ sudo systemctl daemon-reload\n<\/pre>\n
tell systemctl that ipfs should be started on startup:<\/p>\n
$ sudo systemctl enable ipfs\n<\/pre>\n
start ipfs:<\/p>\n
$ sudo systemctl start ipfs\n<\/pre>\n
check status:<\/p>\n
$ sudo systemctl status ipfs\n<\/pre>\n
should see something like<\/p>\n
\u25cf ipfs.service - ipfs daemon\n   Loaded: loaded (\/lib\/systemd\/system\/ipfs.service; enabled; vendor preset: enabled)\n   Active: active (running) since Wed 2019-08-28 20:38:04 UTC; 4s ago\n Main PID: 30133 (ipfs)\n    Tasks: 9 (limit: 4915)\n   CGroup: \/system.slice\/ipfs.service\n           \u2514\u250030133 \/usr\/local\/bin\/ipfs daemon --enable-gc\n\nipfs[30133]: Swarm listening on \/ip4\/127.0.0.1\/tcp\/4001\nipfs[30133]: Swarm listening on \/ip4\/172.31.43.10\/tcp\/4001\nipfs[30133]: Swarm listening on \/ip6\/::1\/tcp\/4001\nipfs[30133]: Swarm listening on \/p2p-circuit\nipfs[30133]: Swarm announcing \/ip4\/127.0.0.1\/tcp\/4001\nipfs[30133]: Swarm announcing \/ip6\/::1\/tcp\/4001\nipfs[30133]: API server listening on \/ip4\/127.0.0.1\/tcp\/5001\nipfs[30133]: WebUI: http:\/\/127.0.0.1:5001\/webui\nipfs[30133]: Gateway (readonly) server listening on \/ip4\/127.0.0.1\/tcp\/80\nipfs[30133]: Daemon is ready\n<\/pre>\n
How to see documents from other that a local web URL.<\/p>\n
By default, the files are only visible for a browser at localhost. To change this, change the gateway and restart the daemon.<\/p>\n
Make gateway publicly accessible. This allows you and everyone to view files.<\/p>\n
If you want to, you can make your IPFS gateway and webui publicly accessible (Note: This should not be done unless locked down with a firewall rule restricting access). Change gateway configuration to listen on all available IP addresses.<\/p>\n
In the file at ~\/.ipfs\/config change the following:<\/p>\n
$ nano ~\/.ipfs\/config \n<\/pre>\n
"API": "\/ip4\/127.0.0.1\/tcp\/5001",\n"Gateway": "\/ip4\/127.0.0.1\/tcp\/8080"\n<\/pre>\n
to…<\/p>\n
 \n"API": "\/ip4\/0.0.0.0\/tcp\/5001",\n"Gateway": "\/ip4\/0.0.0.0\/tcp\/8080"\n<\/pre>\n
You can also run the commands below from the cli:<\/p>\n
$ ipfs config --json API.HTTPHeaders.Access-Control-Allow-Origin '["http:\/\/your_domain_name-or_ip_address.com:5001", "http:\/\/localhost:3000", "http:\/\/127.0.0.1:5001", "https:\/\/webui.ipfs.io"]'\n$ ipfs config --json API.HTTPHeaders.Access-Control-Allow-Methods '["PUT", "GET", "POST"]'\n$ ipfs config Addresses.API \/ip4\/0.0.0.0\/tcp\/5001\n$ ipfs config Addresses.Gateway \/ip4\/0.0.0.0\/tcp\/8080\n<\/pre>\n
Restart IPFS after the changes<\/p>\n
$ sudo systemctl restart ipfs\n<\/pre>\n
Load the URL to your site. In this case, I have an AWS instance but you can use the IP of your server or your domain name.<\/p>\n
http:\/\/ip_address:8080\/ipfs\/QmQPeNsJPyVWPFDVHb77w8G42Fvo15z4bG2X8D2GhfbSXc \n<\/pre>\n
\"\"<\/a><\/p>\n
Webui<\/p>\n
The webui is located at the following URL<\/p>\n
http:\/\/ip_address:5001\/webui\nhttp:\/\/domain-name.com:5001\/webui\n<\/pre>\n
\"\"<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"
Installing IPFS through the command-line is handy if you plan on building applications and services on top of an IPFS node. This method is also useful if you’re setting up a node without a user interface, usually the case with remote servers or virtual machines. Using IPFS through the command-line allows you to do everything … Read more<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[51],"tags":[],"class_list":["post-5758","post","type-post","status-publish","format-standard","hentry","category-ipfs"],"_links":{"self":[{"href":"https:\/\/www.qbytes.cloud\/index.php\/wp-json\/wp\/v2\/posts\/5758","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.qbytes.cloud\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.qbytes.cloud\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.qbytes.cloud\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.qbytes.cloud\/index.php\/wp-json\/wp\/v2\/comments?post=5758"}],"version-history":[{"count":0,"href":"https:\/\/www.qbytes.cloud\/index.php\/wp-json\/wp\/v2\/posts\/5758\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.qbytes.cloud\/index.php\/wp-json\/wp\/v2\/media?parent=5758"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.qbytes.cloud\/index.php\/wp-json\/wp\/v2\/categories?post=5758"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.qbytes.cloud\/index.php\/wp-json\/wp\/v2\/tags?post=5758"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}