{"__v":1,"_id":"5635b293d209b50d0031dfd7","category":{"__v":1,"_id":"5635b291d209b50d0031dfc5","pages":["5635b293d209b50d0031dfd6","5635b293d209b50d0031dfd7","5635b293d209b50d0031dfd8","5635b293d209b50d0031dfd9","5635b293d209b50d0031dfda","5635b293d209b50d0031dfdb","5635b293d209b50d0031dfdc","5635b293d209b50d0031dfdd","5635b293d209b50d0031dfde"],"project":"550a7754635c660d0052808e","version":"5635b290d209b50d0031dfc4","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-03-19T07:14:29.230Z","from_sync":false,"order":0,"slug":"getting-started","title":"Getting Started"},"project":"550a7754635c660d0052808e","user":"5469e5dfa3b67a0e00559b06","version":{"__v":1,"_id":"5635b290d209b50d0031dfc4","project":"550a7754635c660d0052808e","createdAt":"2015-11-01T06:34:56.868Z","releaseDate":"2015-11-01T06:34:56.868Z","categories":["5635b291d209b50d0031dfc5","5635b291d209b50d0031dfc6","5635b291d209b50d0031dfc7","5635b291d209b50d0031dfc8","5635b291d209b50d0031dfc9","5635b291d209b50d0031dfca"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"0.25.0","version":"0.25"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-04-09T03:25:11.500Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":1,"body":"**IMPORTANT: [Nova](https://github.com/TelescopeJS/Telescope/tree/nova) is a new, React-based version of Telescope. Although it's still beta software, it is recommended you use it for any new projects going forward.**\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"The Admin Account\"\n}\n[/block]\nWhen you first access your new Telescope install, you'll be confronted with a few getting started posts. After reading them, the first step will be creating your account. \n\nThe first account you create will automatically be assigned admin rights, which will let you view the admin menu and access Telescope's settings panel. \n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Setting Up Telescope\"\n}\n[/block]\nOnce your account has been created and you've been logged in, you should see a new “admin” menu appear in the navigation bar. This gives you access to a few options, but for now we'll focus on the Settings panel.\n[block:embed]\n{\n  \"html\": \"<iframe class=\\\"embedly-embed\\\" src=\\\"//cdn.embedly.com/widgets/media.html?src=http%3A%2F%2Fwww.youtube.com%2Fembed%2FKtFoXSTQ7bU%3Ffeature%3Doembed&url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DKtFoXSTQ7bU&image=http%3A%2F%2Fi.ytimg.com%2Fvi%2FKtFoXSTQ7bU%2Fhqdefault.jpg&key=02466f963b9b4bb8845a05b53d3235d7&type=text%2Fhtml&schema=youtube\\\" width=\\\"640\\\" height=\\\"480\\\" scrolling=\\\"no\\\" frameborder=\\\"0\\\" allowfullscreen></iframe>\",\n  \"url\": \"https://www.youtube.com/watch?v=KtFoXSTQ7bU\",\n  \"title\": \"Telescope Settings\",\n  \"favicon\": \"https://www.youtube.com/favicon.ico\",\n  \"image\": \"http://i.ytimg.com/vi/KtFoXSTQ7bU/hqdefault.jpg\"\n}\n[/block]\n*Note: Settings screen might have changed slightly since screencast recording.*\n\nThe first thing you'll want to set is probably your site's title. Alternatively, you can also specify an image to be used as logo or tweak the app's color scheme. Don't forget to save by clicking the \"Submit\" button at the bottom of the page. \n\nI also strongly recommend signing up for an [Embedly](http://embed.ly) account and entering your API key in Telescope. This will give you visual thumbnail previews for all your links, which is an easy way to make your site seem a little less bare. \n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"Meteor also provides a built-in way to store settings, in a `settings.json` file. If you prefer that approach, you can also define any Telescope setting in that file (in either `Meteor.settings` or `Meteor.settings.public`) using its property name, and it will be automatically applied.\",\n  \"title\": \"Settings.json\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Email Setup\"\n}\n[/block]\nA few specific emails (such as the password reset email) are sent through the [useraccounts:core](https://github.com/meteor-useraccounts/core) package, but the majority of emails are sent through Telescope's own `telescope:email` package. \n\nIn either case, you'll need to configure either the `MAIL_URL` environment variable (note that if you're hosting on `*.meteor.com`, that will be done for you automatically), or the Mail URL setting in the Settings panel.\n\nYou'll need to enter an SMTP URL, which is usually given by your email provider. It should look something like this:\n\n```\nsmtp://postmaster%40telescope.mailgun.org:password:::at:::smtp.mailgun.org:587/\n```\n\nWhere `postmaster%40telescope.mailgun.org` is your username, `password` is your password, `smtp.mailgun.org` is the SMTP server, and `587` is the port. \n\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Local SMTP Server\",\n  \"body\": \"If you would prefer to use a local email server, you can specify it in the email settings by adding `smtp://localhost:25` to the **Mail URL** field.\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Setting Up Categories\"\n}\n[/block]\nAnother useful panel is the Categories page, also accessible via the Admin menu. \n\nFrom here, you can create predefined categories (such as \"announcements\", \"discussions\", \"resources\", etc.) that you will then be able to assign to each post. \n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Your First Post\"\n}\n[/block]\nWith the set up finished, you're now ready to create your first post! Just click \"post\" and have fun!\n\nThis should be enough to get you started. Have fun with your new site!","excerpt":"Configuring Telescope's settings","slug":"basic-configuration","type":"basic","title":"Basic Configuration"}

Basic Configuration

Configuring Telescope's settings

**IMPORTANT: [Nova](https://github.com/TelescopeJS/Telescope/tree/nova) is a new, React-based version of Telescope. Although it's still beta software, it is recommended you use it for any new projects going forward.** [block:api-header] { "type": "basic", "title": "The Admin Account" } [/block] When you first access your new Telescope install, you'll be confronted with a few getting started posts. After reading them, the first step will be creating your account. The first account you create will automatically be assigned admin rights, which will let you view the admin menu and access Telescope's settings panel. [block:api-header] { "type": "basic", "title": "Setting Up Telescope" } [/block] Once your account has been created and you've been logged in, you should see a new “admin” menu appear in the navigation bar. This gives you access to a few options, but for now we'll focus on the Settings panel. [block:embed] { "html": "<iframe class=\"embedly-embed\" src=\"//cdn.embedly.com/widgets/media.html?src=http%3A%2F%2Fwww.youtube.com%2Fembed%2FKtFoXSTQ7bU%3Ffeature%3Doembed&url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DKtFoXSTQ7bU&image=http%3A%2F%2Fi.ytimg.com%2Fvi%2FKtFoXSTQ7bU%2Fhqdefault.jpg&key=02466f963b9b4bb8845a05b53d3235d7&type=text%2Fhtml&schema=youtube\" width=\"640\" height=\"480\" scrolling=\"no\" frameborder=\"0\" allowfullscreen></iframe>", "url": "https://www.youtube.com/watch?v=KtFoXSTQ7bU", "title": "Telescope Settings", "favicon": "https://www.youtube.com/favicon.ico", "image": "http://i.ytimg.com/vi/KtFoXSTQ7bU/hqdefault.jpg" } [/block] *Note: Settings screen might have changed slightly since screencast recording.* The first thing you'll want to set is probably your site's title. Alternatively, you can also specify an image to be used as logo or tweak the app's color scheme. Don't forget to save by clicking the "Submit" button at the bottom of the page. I also strongly recommend signing up for an [Embedly](http://embed.ly) account and entering your API key in Telescope. This will give you visual thumbnail previews for all your links, which is an easy way to make your site seem a little less bare. [block:callout] { "type": "info", "body": "Meteor also provides a built-in way to store settings, in a `settings.json` file. If you prefer that approach, you can also define any Telescope setting in that file (in either `Meteor.settings` or `Meteor.settings.public`) using its property name, and it will be automatically applied.", "title": "Settings.json" } [/block] [block:api-header] { "type": "basic", "title": "Email Setup" } [/block] A few specific emails (such as the password reset email) are sent through the [useraccounts:core](https://github.com/meteor-useraccounts/core) package, but the majority of emails are sent through Telescope's own `telescope:email` package. In either case, you'll need to configure either the `MAIL_URL` environment variable (note that if you're hosting on `*.meteor.com`, that will be done for you automatically), or the Mail URL setting in the Settings panel. You'll need to enter an SMTP URL, which is usually given by your email provider. It should look something like this: ``` smtp://postmaster%40telescope.mailgun.org:password@smtp.mailgun.org:587/ ``` Where `postmaster%40telescope.mailgun.org` is your username, `password` is your password, `smtp.mailgun.org` is the SMTP server, and `587` is the port. [block:callout] { "type": "info", "title": "Local SMTP Server", "body": "If you would prefer to use a local email server, you can specify it in the email settings by adding `smtp://localhost:25` to the **Mail URL** field." } [/block] [block:api-header] { "type": "basic", "title": "Setting Up Categories" } [/block] Another useful panel is the Categories page, also accessible via the Admin menu. From here, you can create predefined categories (such as "announcements", "discussions", "resources", etc.) that you will then be able to assign to each post. [block:api-header] { "type": "basic", "title": "Your First Post" } [/block] With the set up finished, you're now ready to create your first post! Just click "post" and have fun! This should be enough to get you started. Have fun with your new site!