Tent is a protocol for distributed social networking. Think of something like Twitter or maybe even Facebook working similarly to way email works. Just like anyone can set up their own email server, and send and receive emails entirely independently from others, Tent allows the same to happen with Twitter-like communication. Anyone can set up their Tent server, and publish posts, that are received by followers accross many servers. It's pretty cool, because no single company can control your Tent experience, and because it works, right now.
This short tutorial can help you set up your own Tent server very quickly, but it assumes at least basic understanding of command line. Git or Heroku knowledge might also help. If you have no idea what these things are, you can still be part of Tent - go to Tent.is , and get a free account.
Some conventions: text that is
monospaced and highlighted
should be executed in the command line.
Text that you need to replace (such as username or domain) will be displayed in
heroku login. It will ask for your Heroku email and password. As you type your password, nothing will show up on the command line. That's how it should work - keep calm and type on.
heroku keys:add ~/.ssh/id_rsa.pub
git clone git://github.com/tent/tentd-admin.gitYou might want to
cdto another folder before cloning.
heroku create your_chosen_name --addons heroku-postgresql:devReplace your_chosen_name with something else. It will be accessible at
your_chosen_name.herokuapp.comand can be used as your entity. Entity in Tent is like your @-handle in Twitter. Examples of tent entities are
http://example.org.You follow or mention other Tent users by their entities.
heroku pg:promote $(heroku pg | head -1 | cut -f2 -d" ")
heroku config:add ADMIN_USERNAME=your_chosen_tent_admin_username ADMIN_PASSWORD=your_chosen_tent_admin_password SERVE_ASSETS=1
git push heroku master. It's more that just a simple git push, though, because Heroku will see that this is a Rack app, load the code and restart the server.
.herokuapp.com/admin, login with username and password you just picked, and set up your profile. Then you can authenticate your client (such as TentStatus or Tentia ) and use Tent.
To use your own domain as your entity, there are a few more steps.
heroku config:add TENT_ENTITY=your_domain
Link: <https://example-tent.herokuapp.com/profile>; rel="https://tent.io/rels/profile"to your domain.
<?php header('Link: <https://example-tent.herokuapp.com/profile>; rel="https://tent.io/rels/profile"'); ?>at the top of index.php. It should also be possible with Apache or any other server - what you are looking for is how to add custom HTTP response header to a request to your website's index (or any page).
<link>tag as another way to discover your tent entity.
<head>section in HTML should have a
<link>tag similar to this:
<link href="https://example-tent.herokuapp.com/profile" rel="https://tent.io/rels/profile" />These tags are much easier to add and should work with most clients, but are not as reliable as HTTP response headers, so try that first.
This guide was written by
, and inspired by
You should follow me on Tent as
, or if you are still using that thing called Twitter, as
If you have any feedback about this,
email me my-first-name at my-last-name dot com.